For the complete documentation index, see llms.txt.

POST /v1/venn-links

Create Venn Link

Create a new shareable booking link.

Auth required: Yes

Parameters

• Idempotency-Key (header, string) — Unique key for idempotent POST requests (1-256 chars: alphanumeric, `_`, `-`, `:`, `.`). Same key + same body within 24h replays the cached response.

Request Body

• title: string (required)
• description: string
• duration: integer (required)
• slug: string
• schedule_id: string — Optional schedule ID for availability hours
• event_type_id: string — Optional event type ID — link inherits settings from the event type
• conference_enabled: boolean — Enable Google Meet auto-link on bookings. null/true = enabled, false = disabled.
• price_amount: integer — Price in cents (e.g. 4500 = $45.00). null = inherit from event type, 0 = explicitly free.
• price_currency: string — ISO 4217 currency code (e.g. "usd").
• booking_questions: array — Custom fields to collect at booking time. null = inherit from event type, [] = no questions.
• active: boolean

Responses

• 201: Venn Link created
• 400: Validation error
• 401: Authentication required or invalid
• 409: A request with this Idempotency-Key is currently being processed
• 422: Idempotency-Key was already used with a different request body

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