Skip to content
Docs

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)

FieldTypeRequiredDefault / limits
slugstringyes-
titlestringyes1–120 chars
descriptionstringyesdefault ""; max 2000 chars
durationMinutesintegeryes5–720
bufferBeforeMinutesintegeryesdefault 0; 0–240
bufferAfterMinutesintegeryesdefault 0; 0–240
minNoticeMinutesintegeryesdefault 0; 0–9007199254740991
maxPerDayinteger | nullyesdefault null
locationKind"url" | "phone" | "in_person" | "custom"yesdefault "url"
locationValuestringyesdefault ""; max 500 chars
activebooleanyesdefault true
kind"one_on_one" | "group"yesdefault "one_on_one"
defaultCapacityintegeryesdefault 10; 1–500
color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullyesdefault null
idstring (uuid)yes-
hostIdstring (uuid)yes-
createdAtstring (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

FieldTypeRequiredDefault / limits
slugstringno-
titlestringyes1–120 chars
descriptionstringnodefault ""; max 2000 chars
durationMinutesintegeryes5–720
bufferBeforeMinutesintegernodefault 0; 0–240
bufferAfterMinutesintegernodefault 0; 0–240
minNoticeMinutesintegernodefault 0; 0–9007199254740991
maxPerDayinteger | nullnodefault null
locationKind"url" | "phone" | "in_person" | "custom"nodefault "url"
locationValuestringnodefault ""; max 500 chars
activebooleannodefault true
kind"one_on_one" | "group"nodefault "one_on_one"
defaultCapacityintegernodefault 10; 1–500
color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullnodefault null

Response 201

Body

FieldTypeRequiredDefault / limits
slugstringyes-
titlestringyes1–120 chars
descriptionstringyesdefault ""; max 2000 chars
durationMinutesintegeryes5–720
bufferBeforeMinutesintegeryesdefault 0; 0–240
bufferAfterMinutesintegeryesdefault 0; 0–240
minNoticeMinutesintegeryesdefault 0; 0–9007199254740991
maxPerDayinteger | nullyesdefault null
locationKind"url" | "phone" | "in_person" | "custom"yesdefault "url"
locationValuestringyesdefault ""; max 500 chars
activebooleanyesdefault true
kind"one_on_one" | "group"yesdefault "one_on_one"
defaultCapacityintegeryesdefault 10; 1–500
color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullyesdefault null
idstring (uuid)yes-
hostIdstring (uuid)yes-
createdAtstring (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

FieldTypeRequiredDefault / limits
idstringyes-

Response 200

Body

FieldTypeRequiredDefault / limits
slugstringyes-
titlestringyes1–120 chars
descriptionstringyesdefault ""; max 2000 chars
durationMinutesintegeryes5–720
bufferBeforeMinutesintegeryesdefault 0; 0–240
bufferAfterMinutesintegeryesdefault 0; 0–240
minNoticeMinutesintegeryesdefault 0; 0–9007199254740991
maxPerDayinteger | nullyesdefault null
locationKind"url" | "phone" | "in_person" | "custom"yesdefault "url"
locationValuestringyesdefault ""; max 500 chars
activebooleanyesdefault true
kind"one_on_one" | "group"yesdefault "one_on_one"
defaultCapacityintegeryesdefault 10; 1–500
color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullyesdefault null
idstring (uuid)yes-
hostIdstring (uuid)yes-
createdAtstring (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

FieldTypeRequiredDefault / limits
idstringyes-

Request body

FieldTypeRequiredDefault / limits
slugstringno-
titlestringno1–120 chars
descriptionstringnomax 2000 chars
durationMinutesintegerno5–720
bufferBeforeMinutesintegerno0–240
bufferAfterMinutesintegerno0–240
minNoticeMinutesintegerno0–9007199254740991
maxPerDayinteger | nullno-
locationKind"url" | "phone" | "in_person" | "custom"no-
locationValuestringnomax 500 chars
activebooleanno-
defaultCapacityintegerno1–500
color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullno-

Response 200

Body

FieldTypeRequiredDefault / limits
slugstringyes-
titlestringyes1–120 chars
descriptionstringyesdefault ""; max 2000 chars
durationMinutesintegeryes5–720
bufferBeforeMinutesintegeryesdefault 0; 0–240
bufferAfterMinutesintegeryesdefault 0; 0–240
minNoticeMinutesintegeryesdefault 0; 0–9007199254740991
maxPerDayinteger | nullyesdefault null
locationKind"url" | "phone" | "in_person" | "custom"yesdefault "url"
locationValuestringyesdefault ""; max 500 chars
activebooleanyesdefault true
kind"one_on_one" | "group"yesdefault "one_on_one"
defaultCapacityintegeryesdefault 10; 1–500
color"brand" | "sky" | "emerald" | "amber" | "rose" | "violet" | "teal" | "orange" | nullyesdefault null
idstring (uuid)yes-
hostIdstring (uuid)yes-
createdAtstring (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

FieldTypeRequiredDefault / limits
idstringyes-

Response 200

Body

FieldTypeRequiredDefault / limits
result"deleted" | "deactivated"yes-

Errors: unauthorized, not_found

curl -X DELETE "https://devalender.com/api/event-types/<id>" \
  -H "Authorization: Bearer dvl_..."