Create a Cal.com booking on behalf of the tenant.
POST/api/v1/bookings
Creates a Cal.com v2 booking using the tenant's active Cal.com integration credentials (wire via Settings > Integrations). Does NOT send SMS confirmation (use an AI receptionist with calendar configured for the full conversational flow). Scope: book.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 502
- 504
Booking created
cal_com_not_configured — wire the Cal.com integration first.
Invalid or missing API key
API key lacks the required scope for this endpoint
invalid_event_type — event_type_id not found on the connected account.
slot_taken — start_time is booked or no available users.
cal_com_error — upstream failure (passthrough message).
cal_com_timeout.