Skip to main content
POST
Create a confirmed booking from a thread

Authorizations

Authorization
string
header
required

A Contact Button scoped bearer key. Send Authorization: Bearer <token>. Token abilities are enforced independently of workspace membership; both checks must pass. REST requires a Sanctum API key. Separately, interactive MCP clients can use registered OAuth applications with PKCE and audience-bound workspace grants; those tokens are not REST credentials.

Headers

Idempotency-Key
string

Optional 8–120 character key for replayable mutations. Send the exact same method, URI, and body on retries; receipts expire after 24 hours.

Required string length: 8 - 120

Path Parameters

workspace
string<uuid>
required
thread
string<uuid>
required

Body

application/json
event_type_id
string<uuid>
required
starts_at
string<date-time>
required

A future slot from current availability.

timezone
string
required
email
string<email>
required
Maximum string length: 255
name
string | null
Maximum string length: 255
phone
string | null
Maximum string length: 40
notes
string | null
Maximum string length: 2000
message_id
string<uuid> | null

Response

Successful data envelope.

data
any
required
meta
object
required