Manage event types

Event types define the bookable meetings people can schedule with you, such as a 30-minute discovery call. This recipe walks through the full lifecycle: creating an event type, listing them, updating one, and deleting it. All requests go to the base URL https://api.cal.id and must include your API key in the Authorization header:

Authorization: Bearer calid_xxxxx

Successful responses use a standard envelope:

{
  "success": true,
  "data": {},
  "message": "...",
  "meta": {}
}

Create an event type

Send a POST request to /event-types/. Only title and slug are required; description, length, hidden, timeZone, and locations are optional.

curl -X POST https://api.cal.id/event-types/ \
  -H "Authorization: Bearer calid_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "30 Minute Discovery Call",
    "slug": "discovery-call-30",
    "description": "A short intro call",
    "length": 30
  }'

The response returns the new event type, including its id and slug.

{
  "success": true,
  "data": {
    "id": 101,
    "title": "30 Minute Discovery Call",
    "slug": "discovery-call-30",
    "description": "A short intro call",
    "length": 30
  },
  "message": "Event type created",
  "meta": {}
}

Save the returned id — you’ll use it to fetch, update, or delete this event type.

List event types

Send a GET request to /event-types/. Results are paginated with the page and limit query parameters, and you can filter by title, slug, or hidden.

curl -X GET "https://api.cal.id/event-types/?page=1&limit=10" \
  -H "Authorization: Bearer calid_xxxxx"

{
  "success": true,
  "data": [
    {
      "id": 101,
      "title": "30 Minute Discovery Call",
      "slug": "discovery-call-30",
      "length": 30
    }
  ],
  "message": "Event types retrieved",
  "meta": {
    "page": 1,
    "limit": 10
  }
}

To retrieve a single event type, send a GET request to /event-types/\{id\}.

Update an event type

Send a PATCH request to /event-types/\{id\} with any of the fields you can set on create. Include only the fields you want to change.

curl -X PATCH https://api.cal.id/event-types/101 \
  -H "Authorization: Bearer calid_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Discovery Call",
    "length": 45
  }'

{
  "success": true,
  "data": {
    "id": 101,
    "title": "Updated Discovery Call",
    "slug": "discovery-call-30",
    "length": 45
  },
  "message": "Event type updated",
  "meta": {}
}

Delete an event type

Send a DELETE request to /event-types/\{id\}.

curl -X DELETE https://api.cal.id/event-types/101 \
  -H "Authorization: Bearer calid_xxxxx"

{
  "success": true,
  "data": null,
  "message": "Event type deleted",
  "meta": {}
}

Get started

Guides

Manage event types

Reference

​Reference

Reference