Event types
An event type is something people can book: a title, a duration, buffers, a location and a slug. The slug forms the booking link devalender.com/<handle>/<slug>. All endpoints need an API key.
Group event types (kind: "group") are booked through scheduled sessions instead of free slots. Reserved words cannot be used as slugs; the Free plan allows one event type, and creating more returns plan_limit.
GET /event-types
List event types. Auth: API key.
Response 200
Body (array of objects)
| Field | Type | Required | Default / limits |
|---|---|---|---|
slug | string | yes | - |
title | string | yes | 1–120 chars |
description | string | yes | default ""; max 2000 chars |
durationMinutes | integer | yes | 5–720 |
bufferBeforeMinutes | integer | yes | default 0; 0–240 |
bufferAfterMinutes | integer | yes | default 0; 0–240 |
minNoticeMinutes | integer | yes | default 0; 0–9007199254740991 |
maxPerDay | integer | null | yes | default null |
locationKind | "url" | "phone" | "in_person" | "custom" | yes | default "url" |
locationValue | string | yes | default ""; max 500 chars |
active | boolean | yes | default true |
kind | "one_on_one" | "group" | yes | default "one_on_one" |
defaultCapacity | integer | yes | default 10; 1–500 |
color | "brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | null | yes | default null |
id | string (uuid) | yes | - |
hostId | string (uuid) | yes | - |
createdAt | string (date-time) | yes | - |
Errors: unauthorized
curl -X GET "https://devalender.com/api/event-types" \
-H "Authorization: Bearer dvl_..."POST /event-types
Create an event type. Auth: API key.
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
slug | string | no | - |
title | string | yes | 1–120 chars |
description | string | no | default ""; max 2000 chars |
durationMinutes | integer | yes | 5–720 |
bufferBeforeMinutes | integer | no | default 0; 0–240 |
bufferAfterMinutes | integer | no | default 0; 0–240 |
minNoticeMinutes | integer | no | default 0; 0–9007199254740991 |
maxPerDay | integer | null | no | default null |
locationKind | "url" | "phone" | "in_person" | "custom" | no | default "url" |
locationValue | string | no | default ""; max 500 chars |
active | boolean | no | default true |
kind | "one_on_one" | "group" | no | default "one_on_one" |
defaultCapacity | integer | no | default 10; 1–500 |
color | "brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | null | no | default null |
Response 201
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
slug | string | yes | - |
title | string | yes | 1–120 chars |
description | string | yes | default ""; max 2000 chars |
durationMinutes | integer | yes | 5–720 |
bufferBeforeMinutes | integer | yes | default 0; 0–240 |
bufferAfterMinutes | integer | yes | default 0; 0–240 |
minNoticeMinutes | integer | yes | default 0; 0–9007199254740991 |
maxPerDay | integer | null | yes | default null |
locationKind | "url" | "phone" | "in_person" | "custom" | yes | default "url" |
locationValue | string | yes | default ""; max 500 chars |
active | boolean | yes | default true |
kind | "one_on_one" | "group" | yes | default "one_on_one" |
defaultCapacity | integer | yes | default 10; 1–500 |
color | "brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | null | yes | default null |
id | string (uuid) | yes | - |
hostId | string (uuid) | yes | - |
createdAt | string (date-time) | yes | - |
Errors: invalid_request, unauthorized, reserved_slug, slug_taken, plan_limit
curl -X POST "https://devalender.com/api/event-types" \
-H "Authorization: Bearer dvl_..." \
-H "Content-Type: application/json" \
-d '{"title":"string","durationMinutes":5}'GET /event-types/:id
Get one event type. Auth: API key.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string | yes | - |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
slug | string | yes | - |
title | string | yes | 1–120 chars |
description | string | yes | default ""; max 2000 chars |
durationMinutes | integer | yes | 5–720 |
bufferBeforeMinutes | integer | yes | default 0; 0–240 |
bufferAfterMinutes | integer | yes | default 0; 0–240 |
minNoticeMinutes | integer | yes | default 0; 0–9007199254740991 |
maxPerDay | integer | null | yes | default null |
locationKind | "url" | "phone" | "in_person" | "custom" | yes | default "url" |
locationValue | string | yes | default ""; max 500 chars |
active | boolean | yes | default true |
kind | "one_on_one" | "group" | yes | default "one_on_one" |
defaultCapacity | integer | yes | default 10; 1–500 |
color | "brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | null | yes | default null |
id | string (uuid) | yes | - |
hostId | string (uuid) | yes | - |
createdAt | string (date-time) | yes | - |
Errors: unauthorized, not_found
curl -X GET "https://devalender.com/api/event-types/<id>" \
-H "Authorization: Bearer dvl_..."PATCH /event-types/:id
Update an event type. Auth: API key.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string | yes | - |
Request body
| Field | Type | Required | Default / limits |
|---|---|---|---|
slug | string | no | - |
title | string | no | 1–120 chars |
description | string | no | max 2000 chars |
durationMinutes | integer | no | 5–720 |
bufferBeforeMinutes | integer | no | 0–240 |
bufferAfterMinutes | integer | no | 0–240 |
minNoticeMinutes | integer | no | 0–9007199254740991 |
maxPerDay | integer | null | no | - |
locationKind | "url" | "phone" | "in_person" | "custom" | no | - |
locationValue | string | no | max 500 chars |
active | boolean | no | - |
defaultCapacity | integer | no | 1–500 |
color | "brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | null | no | - |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
slug | string | yes | - |
title | string | yes | 1–120 chars |
description | string | yes | default ""; max 2000 chars |
durationMinutes | integer | yes | 5–720 |
bufferBeforeMinutes | integer | yes | default 0; 0–240 |
bufferAfterMinutes | integer | yes | default 0; 0–240 |
minNoticeMinutes | integer | yes | default 0; 0–9007199254740991 |
maxPerDay | integer | null | yes | default null |
locationKind | "url" | "phone" | "in_person" | "custom" | yes | default "url" |
locationValue | string | yes | default ""; max 500 chars |
active | boolean | yes | default true |
kind | "one_on_one" | "group" | yes | default "one_on_one" |
defaultCapacity | integer | yes | default 10; 1–500 |
color | "brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | null | yes | default null |
id | string (uuid) | yes | - |
hostId | string (uuid) | yes | - |
createdAt | string (date-time) | yes | - |
Errors: invalid_request, unauthorized, reserved_slug, slug_taken, plan_limit, not_found
curl -X PATCH "https://devalender.com/api/event-types/<id>" \
-H "Authorization: Bearer dvl_..." \
-H "Content-Type: application/json" \
-d '{"slug":"string"}'DELETE /event-types/:id
Delete an event type. Auth: API key.
Path parameters
| Field | Type | Required | Default / limits |
|---|---|---|---|
id | string | yes | - |
Response 200
Body
| Field | Type | Required | Default / limits |
|---|---|---|---|
result | "deleted" | "deactivated" | yes | - |
Errors: unauthorized, not_found
curl -X DELETE "https://devalender.com/api/event-types/<id>" \
-H "Authorization: Bearer dvl_..."