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
- 409
- 422
- 424
- 503
Booking created
Validation error on the body, or invalid_event_type: eventTypeId not found on the connected account.
Invalid or missing API key
API key lacks the required scope for this endpoint
slot_taken: startTime is booked or no available users.
cal_com_error: Cal.com rejected the booking (passthrough message, e.g. a required booking field the event type defines).
cal_com_not_configured: wire the Cal.com integration first.
cal_com_timeout, or Cal.com itself failed. Cal.com may have created the booking before the timeout: check the calendar before retrying, a blind retry can double-book.