For the complete documentation index, see llms.txt.

POST /v1/venn-links/{identifier}/book

Book via Venn Link

Create a booking through a Venn Link. **Public Endpoint**: No authentication required. **Free bookings** — confirmed immediately with side effects: - Calendar event created - Confirmation emails sent - Webhooks fired **Paid bookings** — returns `status: pending_payment` and `checkout_url`: - Customer completes payment via Stripe Checkout - On success, webhook confirms booking and fires side effects

Auth required: No

Parameters

• identifier (path, string) (required) — Venn Link short code
• 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

• customer_email: string (required)
• customer_name: string (required)
• start_time: string (required)
• end_time: string (required)
• notes: string
• success_url: string — Override Stripe Checkout success redirect URL (paid bookings only)
• cancel_url: string — Override Stripe Checkout cancel redirect URL (paid bookings only)
• answers: object — Answers to booking questions, keyed by question ID
• recurrence: object — Optional recurrence configuration for creating a recurring booking series

Responses

• 201: Booking created (single or recurring series)
• 400: Validation error
• 404: Resource not found
• 409: Resource conflict
• 422: Idempotency-Key was already used with a different request body

Authentication

This endpoint does not require authentication.

Base URL: https://api.vennio.app