Create a booking

Create a booking for a specific time slot. The API validates that:

1. The human exists and is active
2. The duration matches one of the human’s allowed meeting_durations
3. The time slot falls within working hours (or is covered by an open override)
4. No schedule block overrides conflict with the slot
5. No existing confirmed booking occupies the slot

If another booking was created for the same slot between your agent’s slot query and this request, you’ll receive a 409 SLOT_UNAVAILABLE error. Your agent should retry with the next available slot.

Metadata — pass arbitrary JSON (lead IDs, conversation IDs, ticket numbers) that your agent needs to maintain workflow context. This metadata is included in webhook payloads.

Plan limits — bookings count toward your monthly limit. On paid plans with auto-purchase enabled, overage packs ($19 per 500 bookings) are charged automatically when the limit is reached.