Skip to main content
PATCH
Update booking fields

Headers

cal-api-version
string
default:2026-06-12
required

Must be set to 2026-06-12. If not set to this value, the endpoint will default to an older version.

Example:

"2026-06-12"

Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Path Parameters

eventTypeId
number
required

Body

application/json
bookingFields
(Default Full Name · object | Default Split Name · object | Default Email · object | Default Location · object | Default Title · object | Default Notes · object | Default Guests · object | Default Reschedule Reason · object | Default Attendee Phone · object | Custom Email · object | Custom Phone · object | Custom Address · object | Custom Short Text · object | Custom Number · object | Custom Long Text · object | Custom Select · object | Custom Multi-Select · object | Custom Multiple Emails · object | Custom Checkbox Group · object | Custom Checkbox · object | Custom Radio Group · object | Custom URL · object)[]
required

Booking fields to update. Identify each field by slug and include at least one property to change. field and a custom field's type cannot be changed. Null values and repeated slugs are not allowed. Workflow-added fields are read-only.

Minimum array length: 1

Response

200 - application/json
status
enum<string>
required
Available options:
success,
error
Example:

"success"

data
object
required