API tokens
Send the token in the Authorization header of every request. Tokens start with onc_, are shown once when created and are stored only as a fingerprint.
Authorization: Bearer onc_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
- Who sees what: a staff token sees every event; an organizer token only that organizer’s events; a sandbox key only demo events.
- Expiry and IP allow-list: set when the token is created. Expired or revoked tokens answer
401. - Scopes: give each token only what it needs.
| Scope | What it allows |
|---|---|
| events:read | Read events (names, dates, status, venue) |
| registrations:read | Read registrations, check-in and flight status (no card or passport data) |
| registrations:write | Create, update and cancel registrations |
| invitations:write | Create and read invitations |
| reports:read | Read summary reports (counts by status, check-in, invitations) |
| webhooks:manage | Subscribe and unsubscribe webhooks (Zapier / Make instant triggers) |
OAuth 2.1 (apps that sign people in)
For apps that should act for a person without a pasted token — AI connectors, the Outlook / Teams add-in — ONCORR runs an OAuth 2.1 authorization server:
| What | Address |
|---|---|
| Authorization server metadata (RFC 8414) | https://oncorr.info/.well-known/oauth-authorization-server |
| Protected resource metadata (RFC 9728) | https://oncorr.info/.well-known/oauth-protected-resource/mcp |
| Dynamic client registration (RFC 7591) | POST https://oncorr.info/oauth/register |
| Authorize (consent screen) | GET https://oncorr.info/oauth/authorize |
| Token / refresh | POST https://oncorr.info/oauth/token |
| Revoke (RFC 7009) | POST https://oncorr.info/oauth/revoke |
- Register your app (exact
redirect_uris, https only — http only for localhost). - Send the person to
/oauth/authorizewithresponse_type=code, yourclient_id,redirect_uri,scope,stateand a PKCEcode_challenge(S256 only). - They sign in with their ONCORR staff or organizer account and approve the permissions.
- Exchange the code at
/oauth/tokenwith thecode_verifier. Access tokens live 1 hour; refresh tokens rotate on every use (30 days, sliding).
/mcp) and in the Office add-in only — use a personal API token for server-to-server REST calls.