v1

latestOpenAPI 3.0.32026-07-131670112.4 KB

Event Types

Update event type

Partially update an event type. Only fields included in the request body are changed. Toggle requires_confirmation here to switch between instant-confirm and host-approval flows.

patch/v1/event-types/{id}

Path parameters

idstring required

Request body

Idinteger

titlestring

slugstring

descriptionstring

appointment_labelstring

Custom noun shown to attendees — "appointment", "inspection", "session", etc.

duration_minutesinteger

buffer_beforeinteger

buffer_afterinteger

min_notice_minutesinteger

Minimum advance notice required to book (minutes)

max_bookings_per_dayinteger

locationstring

location_type'video' | 'phone' | 'in_person' | 'other'

webhook_urlstring

custom_fieldsstring

JSON array of custom field definitions

requires_confirmationboolean

Require host to confirm each booking before it is finalized

activeboolean

Response

Default Response

Idinteger

titlestring

slugstring

descriptionstring

appointment_labelstring

Custom noun shown to attendees — "appointment", "inspection", "session", etc.

duration_minutesinteger

buffer_beforeinteger

buffer_afterinteger

min_notice_minutesinteger

Minimum advance notice required to book (minutes)

max_bookings_per_dayinteger

locationstring

location_type'video' | 'phone' | 'in_person' | 'other'

webhook_urlstring

custom_fieldsstring

JSON array of custom field definitions

requires_confirmationboolean

Require host to confirm each booking before it is finalized

activeboolean

Example response

{
  "Id": 14,
  "title": "Urgent Dispatch",
  "slug": "incident-triage",
  "description": "Quick ops intake for new incidents.",
  "appointment_label": "assignment",
  "duration_minutes": 45,
  "buffer_before": 0,
  "buffer_after": 15,
  "min_notice_minutes": 60,
  "max_bookings_per_day": 8,
  "location": "Google Meet",
  "location_type": "video",
  "webhook_url": "https://example.com/hooks/bookings",
  "custom_fields": "[{\"id\":\"site\",\"label\":\"Site\",\"type\":\"text\"}]",
  "requires_confirmation": true,
  "active": true
}