For the complete documentation index, see llms.txt.

POST /v1/calendars/microsoft/link

Link Microsoft (Outlook) Calendar from sign-in tokens (unified auth)

Microsoft equivalent of `POST /v1/calendars/google/link`. Store a Microsoft (Graph) calendar connection from tokens obtained by the app's Microsoft sign-in grant (unified auth: one Azure consent covers identity and calendar). The connection and selected primary calendar are set to the token's own account, replacing any stale selection — making a wrong-account attach impossible. JWT user session only. Stores for the authenticated user.

Auth required: Yes

Request Body

• access_token: string (required) — Microsoft Graph access token from the sign-in session
• refresh_token: string — Graph refresh token, if re-issued (omit to preserve a stored one)
• expires_in: integer — Seconds until the access token expires (default 3600)

Responses

• 201: Calendar linked
• 400: Validation error
• 401: Authentication required or invalid
• 403: A user session is required (API keys cannot link a calendar).
• 422: The token lacks the Calendars scope (cannot read the calendar) — e.g. an existing user's cached grant. Nothing was stored. The client should re-run sign-in with `prompt=consent` to obtain the scope.

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