bookings

Create a booking

Creates a real appointment at the provider. Requires a mandate (mandateRef) created from the user's instruction. The slot is revalidated at booking time. Check the service's bookingRequirements first (e.g. phone required) — missing details return 400 with the missing fields. Include a stable idempotencyKey so retries never double-book.

post/bookings

Request

Base URL: https://agentbookable.com
URL: https://agentbookable.com/bookings
Auth: none declared

Request body

businessIdstring required

serviceIdstring required

slotIdstring

Slot id from the availability call (preferred)

mandateRefstring required

From POST /mandates — single-use, expires in 15 minutes

idempotencyKeystring

Stable key for safe retries

draftIdstring

The consented draft (from POST /booking-drafts + POST /mandates/for-draft). Request must match the draft exactly.

Response

Confirmed booking

idstring

businessIdstring

serviceIdstring

staffIdstring nullable

startstring

endstring

status'confirmed' | 'pending' | 'cancelled' | 'completed'

createdVia'agent'

mandateRefstring

createdAtstring

updatedAtstring

Example response

{
  "id": "bb_bkg_3e74e9ebd024c32b"
}

Changes

No recorded changes to this operation across all 1 revision of this API.