Getting started

Choose the right path

Use case	Use	Credential
Trusted backend creates or manages registrations	@wodira/sdk	Secret key wd_live_...
Public website lists events and creates checkout	@wodira/browser	Publishable key wpk_live_...
Public website without building UI from scratch	@wodira/browser/ui	Publishable key wpk_live_...
No SDK	Direct HTTP	Secret or publishable depending on endpoint

Get your API keys in WODira

Keys are created from the private organizer dashboard under Organization profile → API.

Secret keyFor trusted backends with scopes and wd_live_....Publishable keyFor public websites with allowed origins and wpk_live_....

1. Sign in to WODira with an organizer account.
2. Open your organization and go to Organization profile.
3. Select the API tab. Example route: /organizer/{organizationId}/profile?tab=api.
4. In New key, choose the type:
   • Secret key (backend) for @wodira/sdk or the Organizer API.
   • Publishable key (frontend) for @wodira/browser, @wodira/browser/ui, or the Browser API.
5. Add a recognizable name, for example official website, production backend, or 2026 landing.
6. For publishable keys, add Allowed origins: one domain per line, such as https://organizer.com and https://www.organizer.com.
7. For secret keys, select the minimum scopes needed.
8. Optionally set an expiration date and click Create key.
9. Copy the full key immediately: WODira only shows it once.

Important

If you lose a key, revoke it from Existing keys and create a new one. Do not share secret keys over email, Slack, or public JavaScript.

Recommended browser flow

1. Create a publishable key with the external website domain in allowedOrigins.
2. Install @wodira/browser or @wodira/browser/ui.
3. Read the public event and categories with getEvent and getPricingCards.
4. Create a Checkout Session with createRegistrationCheckoutSession, termsAccepted, required waivers, and idempotencyKey.
5. Redirect to the Stripe Checkout sessionUrl.