Skip to content
O ONCORR

Colour theme

Text size

Contrast

Request a quote

Authentication

API tokens, scopes and OAuth 2.1.

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.
Scopes
ScopeWhat it allows
events:readRead events (names, dates, status, venue)
registrations:readRead registrations, check-in and flight status (no card or passport data)
registrations:writeCreate, update and cancel registrations
invitations:writeCreate and read invitations
reports:readRead summary reports (counts by status, check-in, invitations)
webhooks:manageSubscribe 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:

OAuth endpoints
WhatAddress
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 / refreshPOST https://oncorr.info/oauth/token
Revoke (RFC 7009)POST https://oncorr.info/oauth/revoke
  1. Register your app (exact redirect_uris, https only — http only for localhost).
  2. Send the person to /oauth/authorize with response_type=code, your client_id, redirect_uri, scope, state and a PKCE code_challenge (S256 only).
  3. They sign in with their ONCORR staff or organizer account and approve the permissions.
  4. Exchange the code at /oauth/token with the code_verifier. Access tokens live 1 hour; refresh tokens rotate on every use (30 days, sliding).
OAuth access tokens work at the MCP endpoint (/mcp) and in the Office add-in only — use a personal API token for server-to-server REST calls.