Guest Calendar Connect (Google)
Creates a guest user and redirects to Google OAuth. **Public Endpoint**: No authentication required. **Use Case**: A business's end-customer connects their Google Calendar without needing a Vennio account. The endpoint creates a throwaway guest user, then internally mints a connect token and redirects through the standard token-gated Google OAuth flow. **Security**: `redirect_url` is validated against a hard-coded platform domain allowlist and a per-business `business_redirect_uris` whitelist. External URIs not on either list are rejected with 400.
Auth required: No
principal_id (query, string) (required) — UUID of the business whose calendar the guest is connecting to. Also accepts `business_id` (alias).business_id (query, string) — Alias for `principal_id`. Send either, not both.redirect_url (query, string) — URL to redirect after OAuth completes. Must be HTTPS and on the business's redirect URI whitelist.302: Redirect to Google OAuth consent screen400: Invalid request (missing principal_id, invalid redirect_url, or redirect_url not whitelisted)This endpoint does not require authentication.
Base URL: https://api.vennio.app