Event Types

Event types define the rules for a bookable meeting — duration, buffer times, required skills, and custom fields.

List event types

GET /event-types

Returns all active event types for the organization.

Get a specific event type

GET /event-types/{id}

Returns full details including custom fields in their display order.

Custom fields

Event types can have custom fields that collect information from the attendee at booking time. Pass them in customFields when creating a booking:

{
  "eventTypeId": "evt_01abc",
  "attendee": { "name": "Jane", "email": "jane@example.com" },
  "requestedTime": "2026-05-01T14:00:00Z",
  "customFields": {
    "company": "Acme Inc",
    "topic": "Product demo"
  }
}

To discover the available fields and their keys:

GET /event-types/{id}/fields

Response:

{
  "success": true,
  "fields": [
    {
      "id": "fld_01abc",
      "key": "company",
      "label": "Company",
      "type": "TEXT",
      "required": true
    },
    {
      "id": "fld_01def",
      "key": "topic",
      "label": "What would you like to discuss?",
      "type": "SELECT",
      "required": false,
      "options": ["Product demo", "Support", "Partnership"]
    }
  ]
}

Scheduling types

Value	Behavior
`SOLO`	Assigned to one member by routing algorithm
`ROUND_ROBIN`	Distributed evenly across team members
`COLLECTIVE`	Requires all team members to be available

Event Types

List event types

Get a specific event type

Custom fields

Scheduling types

On this page