mandates

Record the user's booking instruction (authorization)

Creates a short-lived, single-use mandate that authorizes ONE booking action for ONE business. The instruction must be the user's own words — agents must not fabricate it. Use the returned mandateRef in POST /bookings within 15 minutes. The mandate is consumed by the booking it authorizes.

post/mandates

Request

  • Base URL: https://agentbookable.com
  • URL: https://agentbookable.com/mandates
  • Auth: none declared

Request body

actorRefstring required

Stable identifier for who is acting on the user's behalf (e.g. your agent/session id). Used in the audit trail.

action'create_booking' | 'reschedule_booking' | 'cancel_booking' required
businessIdstring

Bind the mandate to this business. Strongly recommended; a bound mandate cannot be replayed elsewhere.

serviceIdstring

Optionally bind to a specific service.

instructionstring required

The user's exact words. Do not paraphrase or invent. This is the consent evidence.

Example request

{
  "actorRef": "assistant-session-42",
  "businessId": "ab_bus_c24850fce8cfb9db",
  "instruction": "Book the 09:00 haircut on 1 September."
}

Response

Mandate created

mandateRefstring
expiresAtstring

The mandate is invalid after this time (15 minutes).

Example response

{
  "mandateRef": "mandate_76a00b335de7bd57"
}

Changes

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