Event Types API Reference

Detailed documentation for event type endpoints in the Cal.diy API v2.

Endpoints Overview

List Event Types

GET /v2/event-types

Query Parameters

Response

{
  "status": "success",
  "data": [
    {
      "id": 123,
      "title": "30 Minute Meeting",
      "slug": "30min",
      "description": "A quick 30 minute call",
      "lengthInMinutes": 30,
      "locations": [
        {
          "type": "integration",
          "integration": "cal-video"
        }
      ],
      "bookingFields": [],
      "disableGuests": false,
      "slotInterval": null,
      "minimumBookingNotice": 120,
      "beforeEventBuffer": 0,
      "afterEventBuffer": 0,
      "schedulingType": null,
      "metadata": {},
      "requiresConfirmation": false,
      "price": 0,
      "currency": "usd",
      "hidden": false
    }
  ]
}

Create an Event Type

POST /v2/event-types

Request Body

{
  "title": "30 Minute Meeting",
  "slug": "30min",
  "description": "A quick 30 minute call to discuss your needs",
  "lengthInMinutes": 30,
  "locations": [
    {
      "type": "integration",
      "integration": "cal-video"
    }
  ],
  "bookingFields": [
    {
      "type": "textarea",
      "name": "notes",
      "label": "Additional Notes",
      "required": false,
      "placeholder": "Any additional information..."
    }
  ],
  "disableGuests": false,
  "slotInterval": 15,
  "minimumBookingNotice": 120,
  "beforeEventBuffer": 5,
  "afterEventBuffer": 5,
  "scheduleId": 1,
  "requiresConfirmation": false,
  "hidden": false
}

Required Fields

Optional Fields

Location Types

Cal Video (Built-in)

{
  "type": "integration",
  "integration": "cal-video"
}

Zoom

{
  "type": "integration",
  "integration": "zoom"
}

Google Meet

{
  "type": "integration",
  "integration": "google-meet"
}

Microsoft Teams

{
  "type": "integration",
  "integration": "msteams"
}

In-Person

{
  "type": "address",
  "address": "123 Main St, City, Country"
}

Phone Call (Host Calls)

{
  "type": "userPhone"
}

Phone Call (Attendee Provides)

{
  "type": "attendeePhone"
}

Custom Link

{
  "type": "link",
  "link": "https://custom-meeting.com/room"
}

Booking Fields

Custom form fields for collecting information from attendees.

Text Field

{
  "type": "text",
  "name": "company",
  "label": "Company Name",
  "required": true,
  "placeholder": "Enter your company name"
}

Textarea

{
  "type": "textarea",
  "name": "notes",
  "label": "Additional Notes",
  "required": false
}

Select (Dropdown)

{
  "type": "select",
  "name": "topic",
  "label": "Meeting Topic",
  "required": true,
  "options": [
    { "value": "sales", "label": "Sales Inquiry" },
    { "value": "support", "label": "Support" },
    { "value": "other", "label": "Other" }
  ]
}

Radio Buttons

{
  "type": "radio",
  "name": "preference",
  "label": "Preferred Contact Method",
  "required": true,
  "options": [
    { "value": "email", "label": "Email" },
    { "value": "phone", "label": "Phone" }
  ]
}

Checkbox

{
  "type": "checkbox",
  "name": "terms",
  "label": "I agree to the terms",
  "required": true
}

Phone Number

{
  "type": "phone",
  "name": "phone",
  "label": "Phone Number",
  "required": false
}

Get an Event Type

GET /v2/event-types/{eventTypeId}

Path Parameters

Update an Event Type

PATCH /v2/event-types/{eventTypeId}

Request Body

Only include fields you want to update:

{
  "title": "Updated Meeting Title",
  "lengthInMinutes": 45,
  "hidden": false
}

Delete an Event Type

DELETE /v2/event-types/{eventTypeId}

Team Event Types

For team event types, use the team-scoped endpoints:

List Team Event Types

GET /v2/teams/{teamId}/event-types

Create Team Event Type

POST /v2/teams/{teamId}/event-types

Additional fields for team event types:

{
  "title": "Team Meeting",
  "slug": "team-meeting",
  "lengthInMinutes": 30,
  "schedulingType": "ROUND_ROBIN",
  "hosts": [
    { "userId": 1, "isFixed": false },
    { "userId": 2, "isFixed": false }
  ]
}

Scheduling Types

Private Links

Create private booking links that bypass public visibility:

List Private Links

GET /v2/event-types/{eventTypeId}/private-links

Create Private Link

POST /v2/event-types/{eventTypeId}/private-links

Organization Event Types

For organization-level event type management:

List Organization Teams

GET /v2/organizations/{orgId}/teams

Response

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Sales Team",
      "slug": "sales",
      "parentId": null,
      "isOrganization": false
    }
  ]
}

Get Team Event Types (Organization Scope)

GET /v2/organizations/{orgId}/teams/{teamId}/event-types

Create Team Event Type (Organization Scope)

POST /v2/organizations/{orgId}/teams/{teamId}/event-types

Team event types support different scheduling modes:

Event Type Webhooks

Configure webhooks specific to an event type:

List Event Type Webhooks

GET /v2/event-types/{eventTypeId}/webhooks

Create Event Type Webhook

POST /v2/event-types/{eventTypeId}/webhooks

{
  "subscriberUrl": "https://your-app.com/webhook",
  "triggers": ["BOOKING_CREATED"],
  "active": true
}