For the complete documentation index, see llms.txt.

POST /v1/oauth/connect-token

Mint Calendar Connect Token

Create a single-use, short-lived token for initiating calendar OAuth. The token binds the authenticated user's identity and optional metadata (redirect URL, business ID) into a server-side record. Pass the returned token to `GET /v1/calendars/google/connect` or `GET /v1/calendars/microsoft/connect` as the `token` query parameter. Tokens expire after 5 minutes and are consumed on first use.

Auth required: Yes

Request Body

• provider: string (required) — Calendar provider to connect
• redirect_url: string — Where to redirect after OAuth completion (must be HTTPS)
• principal_id: string — Business UUID for auto-creating a business-customer connection post-OAuth
• business_id: string — Alias for `principal_id`. Send either, not both.

Responses

• 201: Connect token created
• 400: Invalid request (bad redirect_url or missing provider)
• 401: Authentication required or invalid
• 429: Rate limit exceeded (10 requests per minute per user)

Authentication

Requires authentication. Pass a Bearer token (Supabase JWT) or an API key (`Authorization: Bearer vennio_sk_live_*`) in the request headers.

Base URL: https://api.vennio.app