Secret keys and Organizer API

Use secret keys for server-to-server integrations.

Create a secret key in WODira

Use secret keys only in trusted backends. Never include them in frontend bundles, HTML, public mobile apps, or repositories.

1. In WODira, go to Organization profile → API.
2. In New key, select Secret key (backend).
3. Add a recognizable name, for example production backend or CRM sync.
4. Select only the scopes required by that integration.
5. Optionally set an expiration date.
6. Click Create key.
7. Copy the wd_live_... key immediately and store it in a secret manager or environment variable.

Recommended example:

WODIRA_API_KEY=wd_live_...

If a secret key leaks or is no longer used, revoke it from Existing keys and create a new one.

Scopes

Scope	Permission
events:read	Read events, categories, form fields, waivers, sponsors, and active supplements.
pricing:read	Read pricing cards, quotas, and active prices.
registrations:read	Search registrations.
registrations:write	Create, update, and cancel registrations.

Endpoints

Each method has equivalent examples with @wodira/sdk, curl, and PHP without an SDK.

Method	Path	Scope	Examples
POST	/events/search	events:read	searchEvents
GET	/events/:eventId	events:read	getEvent
GET	/events/:eventId/pricing-cards	pricing:read	getPricingCards
POST	/registrations	registrations:write	createRegistration
POST	/registrations/search	registrations:read	searchRegistrations
PATCH	/registrations/:ticketId	registrations:write	updateRegistration
DELETE	/registrations/:ticketId	registrations:write	deleteRegistration