For the complete documentation index, see llms.txt.

POST /v1/hosts/{id}/connect-link

Create Host Connect Link

Return a single-use, 5-minute hosted Google calendar-connect URL for a managed host. Send it to the coach; they connect their own calendar to their own principal. The account must manage this host.

Auth required: Yes

Parameters

• id (path, string) (required) — The host principal_id.

Request Body

• redirect_url: string — Where to send the coach after connecting. Must be a platform domain or whitelisted for this account.

Responses

• 201: Connect link generated
• 403: Host is not managed by your account

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