v1

latestOpenAPI 3.0.32026-07-131670112.4 KB
Public

Create an assignment

Submit an assignment request for an individual host's assignment type. Returns confirmation including cancel_url and reschedule_url. If requires_confirmation: true, status will be pending until the host confirms.

post/v1/assign/{username}/{event_slug}

Path parameters

usernamestring required
event_slugstring required

Request body

start_timestring required

ISO 8601 datetime from the /v1/slots response

attendee_namestring required
attendee_emailstring email required
attendee_timezonestring
notesstring
custom_responsesobject

Answers to custom fields defined on the assignment type

Response

Default Response

object required

Example response

{
  "Id": 88,
  "uid": "bk_abc123def456",
  "event_type_id": "14",
  "user_id": "7",
  "attendee_name": "Taylor Brooks",
  "attendee_email": "taylor@example.com",
  "attendee_timezone": "America/Chicago",
  "start_time": "2026-03-20T15:00:00.000Z",
  "end_time": "2026-03-20T15:30:00.000Z",
  "status": "confirmed",
  "cancel_url": "/cancel/cancel_tok_123",
  "reschedule_url": "/reschedule/res_tok_123"
}