Create Guest Connect Link (Google)
Mint a single-use, 5-minute URL that lets one of your customers connect their Google Calendar to your account without a Vennio account. **Mint on click, redirect immediately.** Call this from your server when the customer clicks "Connect calendar", then redirect their browser to `connect_url`. The URL expires after 5 minutes and works once, so don't email it or embed it in a page. Your account is the business: it comes from the API key. `reference` and `redirect_url` are bound into the link, so the customer can't change them. `redirect_url` is checked against your redirect whitelist now, at mint time. Each call creates one guest principal for the customer. When they finish Google sign-in, Vennio connects the guest to your account and reports it the same way as `GET /v1/calendars/google/connect-guest` (webhook `consent.granted`, plus `principal_id` and `reference` on the redirect).
Auth required: Yes
redirect_url: string — Where to send the customer after connecting. Must be `https:`
(or `http:` on localhost), have no fragment, and be a platform
domain or on your redirect URI whitelist.
reference: string — Your own identifier for this customer or order (e.g. a trip
ID). Echoed back on the redirect and in the `consent.granted`
webhook. 1-128 characters: letters, digits, `.`, `_`, `:`, `-`.
201: Connect link created400: Invalid request: `invalid_redirect_url`, `redirect_url_not_whitelisted`,
`invalid_reference`, or `principal_id_not_supported` (the business is
the caller; `principal_id` and `business_id` are not accepted).
A body field of the wrong type returns a `ProblemDetail` validation error instead.
401: Authentication required or invalid403: A publishable key was used (a secret key is required), or `not_a_business` (the caller is not a business account).429: Rate limit exceeded (10 requests per minute per account)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