Meeting types
The meetings people can book with you.
Path parameters
The endpoints whose path names one of these take it as described here. An endpoint's own table lists a path parameter only when it describes it differently.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
meetingTypeId | path | integer (int64) | required | The meeting type's id. |
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy. |
X-Ken-Workspace-Id | header | integer (int64) | optional | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found. |
List meeting types
/v1/meeting-typesmeeting-types.list- Permission
- Calendar view
- Rate limit
- 12,000 requests a minute per API key
scheduler feature on your workspace. Until it is on, calls answer 404.Lists the workspace's meeting types, oldest first. Every member who can view meetings sees every type, including types that are turned off.
Combine any of these filters: ownerMemberId (one member's personal types), kind (personal, round_robin or collective, several separated by commas) and hostMemberId (the team types that list this member as a host). Page with limit, from 1 to 200 (default 50), and the cursor from pagination.nextCursor. When you have no meeting type yet, Kenso creates an "Intro call" type for you from the workspace's booking defaults the first time you list.
Errors:
400 validation_failed:kindholds an unknown value, or a member id is 0.403 forbidden: the API key is not tied to a member of the workspace.
Requires Meetings view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
ownerMemberId | query | integer (int64) | optional | Only meeting types this member owns, by member id. Team types have no owner, so this filter leaves them out. |
kind | query | string | optional | Only these kinds, as a comma-separated list of personal, round_robin and collective. Omitted returns every kind. |
hostMemberId | query | integer (int64) | optional | Only team types that list this member as a host, by member id. Personal types never match. |
limit | query | integer (int32) | optional | Number of meeting types per page, from 1 to 200. Default 50. |
cursor | query | string | optional | The nextCursor from the previous page. Omit it for the first page. |
curl -X GET "https://api.ken.so/v1/meeting-types?limit=50" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a list of MeetingType. Each item has these fields. The response also carries pagination.
Show the 25 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Create a meeting type
/v1/meeting-typesmeeting-types.create- Permission
- Calendar view
- Rate limit
- 4,800 requests a minute per API key
scheduler feature on your workspace. Until it is on, calls answer 404.Creates a meeting type. It starts from the workspace's booking defaults, and every field you send overrides them.
name is required. Kenso builds the slug from the name when you leave it out. kind is personal (the default), round_robin or collective.
A personal type belongs to ownerMemberId, which defaults to you. Creating one for another member needs the members permission. A member's first personal type becomes their default type.
A team type takes hostMemberIds instead of an owner. Only a member with the members permission can create one, and the workspace needs a paid plan.
availability sets the type's own weekly hours and date overrides for every host. Leave it out to use each host's own hours. Busy time on the host's calendar, the minimum notice, the booking window, the buffers and the daily cap still apply on top of it.
Errors:
400 validation_failed: a field is missing, unknown or out of range. Each entry indetailsnames the field by its path, such asavailability.weekly.monday[0].end.402 plan_limit_reached: team types need a paid plan.403 forbidden: you need thememberspermission for another member's type or a team type.403 permission_denied: Client seats cannot create meeting types.404 not_found:ownerMemberIdis not a member of this workspace.409 conflict: the slug is taken by another type of the same owner, now or as an old link (slug_taken).
Requires Meetings view.
Request body
application/json, optional.
| Field | Type | Required | Description |
|---|---|---|---|
lengthMinutes | integer (int32) | optional | How long the meeting lasts, 5 to 720 minutes. Cannot be null. |
locationKind | string | optional | Where the meeting happens: video, phone, in_person, custom, or one conference tool: google_meet, microsoft_teams, zoom or webex. Cannot be null. Changing it clears locationDetail unless you send that too. |
locationDetail | string | optional | The address, link or instructions, up to 500 characters. Required for in_person and custom, refused for a conference tool. Null clears it. |
minimumNoticeMinutes | integer (int32) | optional | How soon before a meeting it can still be booked, 0 to 43,200 minutes (30 days). Cannot be null. |
bookingWindowDays | integer (int32) | optional | How far ahead people can book, 1 to 365 days. Cannot be null. |
bufferBeforeMinutes | integer (int32) | optional | Free time kept before each meeting, 0 to 240 minutes. Cannot be null. |
bufferAfterMinutes | integer (int32) | optional | Free time kept after each meeting, 0 to 240 minutes. Cannot be null. |
dailyCap | integer (int32) | optional | The most bookings a host takes in a day, 1 to 100. Null turns the cap off. |
reminderEnabled | boolean | optional | Whether the booker gets a reminder email 24 hours before the meeting. Cannot be null. |
reminderText | string | optional | Your own text for the reminder email, up to 2,000 characters. Null clears it, and the reminder uses Kenso's text. |
questions | array of MeetingTypeQuestionInput | optional | Up to 5 questions the booker answers, replacing the whole list. Null removes every question. |
name | string | optional | The type's name, 1 to 100 characters. Required on create. Cannot be null. |
slug | string | optional | The type's part of the booking link: lowercase letters, digits and hyphens, up to 63 characters, unique for the owner. Kenso builds it from the name when you leave it out on create. |
description | string | optional | What the booker reads about the meeting, up to 2,000 characters. Null clears it. |
isSecret | boolean | optional | Whether the type is secret: bookable by its link but not listed on the member's booking page. |
isEnabled | boolean | optional | Whether people can book the type. False turns it off without deleting it. |
isDefault | boolean | optional | Send true to make this the owner's default type. To move the default, send true on the new default type. |
availability | AvailabilitySchedule | optional | The type's own available times for every host, replacing the whole schedule. Null clears it, so each host's own hours apply. Left out on create, the type has none. |
kind | string | optional | The kind of type: personal (the default), round_robin or collective. Team kinds need the members permission and a paid plan. |
ownerMemberId | integer (int64) | optional | The member who owns a personal type. Defaults to you; another member needs the members permission. |
hostMemberIds | array of integer (int64) | optional | For team kinds only: the hosts in order, 2 to 10 for round_robin and 2 to 4 for collective, where the first host organizes. Each host needs a connected calendar. |
curl -X POST "https://api.ken.so/v1/meeting-types" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"lengthMinutes": 1,
"locationKind": "google_meet",
"locationDetail": "string",
"minimumNoticeMinutes": 1,
"bookingWindowDays": 1,
"bufferBeforeMinutes": 1,
"bufferAfterMinutes": 1,
"dailyCap": 1,
"reminderEnabled": true,
"reminderText": "string",
"questions": [
{
"id": "string",
"label": "string",
"kind": "short_text",
"required": true,
"options": [
"string"
]
}
],
"name": "string",
"slug": "string",
"description": "string",
"isSecret": true,
"isEnabled": true,
"isDefault": true,
"availability": {
"timeZone": "America/New_York",
"weekly": {
"monday": [
{
"start": "string",
"end": "string"
}
],
"tuesday": [
{
"start": "string",
"end": "string"
}
],
"wednesday": [
{
"start": "string",
"end": "string"
}
],
"thursday": [
{
"start": "string",
"end": "string"
}
],
"friday": [
{
"start": "string",
"end": "string"
}
],
"saturday": [
{
"start": "string",
"end": "string"
}
],
"sunday": [
{
"start": "string",
"end": "string"
}
]
},
"overrides": [
{
"date": "string",
"ranges": [
{
"start": "string",
"end": "string"
}
]
}
]
},
"kind": "personal",
"ownerMemberId": 812,
"hostMemberIds": [
812
]
}'Response 201
data is a MeetingType.
Show the 25 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Get a meeting type
/v1/meeting-types/{meetingTypeId}meeting-types.get- Permission
- Calendar view
- Rate limit
- 12,000 requests a minute per API key
scheduler feature on your workspace. Until it is on, calls answer 404.Returns one meeting type with its booking rules, questions, availability and, for a team type, its hosts. Any member who can view meetings reads any type in the workspace.
Errors:
403 forbidden: the API key is not tied to a member of the workspace.404 not_found: no live meeting type has this id in the workspace.
Requires Meetings view.
curl -X GET "https://api.ken.so/v1/meeting-types/812" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a MeetingType.
Show the 25 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Update a meeting type
/v1/meeting-types/{meetingTypeId}meeting-types.update- Permission
- Calendar view
- Rate limit
- 4,800 requests a minute per API key
scheduler feature on your workspace. Until it is on, calls answer 404.Changes the fields you send and keeps the rest. Members change their own personal types. Another member's type and every team type need the members permission.
Send null to clear locationDetail, description, dailyCap, reminderText, questions or availability. Clearing availability sends each host back to their own hours, and a schedule you send replaces the whole schedule. A new slug keeps the old link working: Kenso redirects it. isDefault: true makes the type its owner's default; to move the default, send true on the new default type. On a team type, hostMemberIds replaces the whole host list, and turning the type back on with isEnabled: true needs a paid plan.
Errors:
400 validation_failed: the body is missing, a field is unknown or out of range,isDefaultis false or null, orhostMemberIdswas sent for a personal type.402 plan_limit_reached: turning a team type on needs a paid plan.403 forbidden: you need thememberspermission for another member's type or a team type.403 permission_denied: Client seats cannot change meeting types.404 not_found: no live meeting type has this id in the workspace.409 conflict: the new slug is taken (slug_taken), or another request changed the owner's default type at the same time (default_changed).
Requires Meetings view.
Request body
application/json, optional.
| Field | Type | Required | Description |
|---|---|---|---|
lengthMinutes | integer (int32) | optional | How long the meeting lasts, 5 to 720 minutes. Cannot be null. |
locationKind | string | optional | Where the meeting happens: video, phone, in_person, custom, or one conference tool: google_meet, microsoft_teams, zoom or webex. Cannot be null. Changing it clears locationDetail unless you send that too. |
locationDetail | string | optional | The address, link or instructions, up to 500 characters. Required for in_person and custom, refused for a conference tool. Null clears it. |
minimumNoticeMinutes | integer (int32) | optional | How soon before a meeting it can still be booked, 0 to 43,200 minutes (30 days). Cannot be null. |
bookingWindowDays | integer (int32) | optional | How far ahead people can book, 1 to 365 days. Cannot be null. |
bufferBeforeMinutes | integer (int32) | optional | Free time kept before each meeting, 0 to 240 minutes. Cannot be null. |
bufferAfterMinutes | integer (int32) | optional | Free time kept after each meeting, 0 to 240 minutes. Cannot be null. |
dailyCap | integer (int32) | optional | The most bookings a host takes in a day, 1 to 100. Null turns the cap off. |
reminderEnabled | boolean | optional | Whether the booker gets a reminder email 24 hours before the meeting. Cannot be null. |
reminderText | string | optional | Your own text for the reminder email, up to 2,000 characters. Null clears it, and the reminder uses Kenso's text. |
questions | array of MeetingTypeQuestionInput | optional | Up to 5 questions the booker answers, replacing the whole list. Null removes every question. |
name | string | optional | The type's name, 1 to 100 characters. Required on create. Cannot be null. |
slug | string | optional | The type's part of the booking link: lowercase letters, digits and hyphens, up to 63 characters, unique for the owner. Kenso builds it from the name when you leave it out on create. |
description | string | optional | What the booker reads about the meeting, up to 2,000 characters. Null clears it. |
isSecret | boolean | optional | Whether the type is secret: bookable by its link but not listed on the member's booking page. |
isEnabled | boolean | optional | Whether people can book the type. False turns it off without deleting it. |
isDefault | boolean | optional | Send true to make this the owner's default type. To move the default, send true on the new default type. |
availability | AvailabilitySchedule | optional | The type's own available times for every host, replacing the whole schedule. Null clears it, so each host's own hours apply. Left out on create, the type has none. |
hostMemberIds | array of integer (int64) | optional | For team types only: the whole ordered host list. A host already on the type can stay while their calendar needs reconnecting. |
curl -X PATCH "https://api.ken.so/v1/meeting-types/812" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
"lengthMinutes": 1,
"locationKind": "google_meet",
"locationDetail": "string",
"minimumNoticeMinutes": 1,
"bookingWindowDays": 1,
"bufferBeforeMinutes": 1,
"bufferAfterMinutes": 1,
"dailyCap": 1,
"reminderEnabled": true,
"reminderText": "string",
"questions": [
{
"id": "string",
"label": "string",
"kind": "short_text",
"required": true,
"options": [
"string"
]
}
],
"name": "string",
"slug": "string",
"description": "string",
"isSecret": true,
"isEnabled": true,
"isDefault": true,
"availability": {
"timeZone": "America/New_York",
"weekly": {
"monday": [
{
"start": "string",
"end": "string"
}
],
"tuesday": [
{
"start": "string",
"end": "string"
}
],
"wednesday": [
{
"start": "string",
"end": "string"
}
],
"thursday": [
{
"start": "string",
"end": "string"
}
],
"friday": [
{
"start": "string",
"end": "string"
}
],
"saturday": [
{
"start": "string",
"end": "string"
}
],
"sunday": [
{
"start": "string",
"end": "string"
}
]
},
"overrides": [
{
"date": "string",
"ranges": [
{
"start": "string",
"end": "string"
}
]
}
]
},
"hostMemberIds": [
812
]
}'Response 200
data is a MeetingType.
Show the 25 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
Delete a meeting type
/v1/meeting-types/{meetingTypeId}meeting-types.delete- Permission
- Calendar view
- Rate limit
- 4,800 requests a minute per API key
scheduler feature on your workspace. Until it is on, calls answer 404.Deletes a meeting type. When you delete a member's default type, their oldest other personal type becomes the default.
A member always keeps at least one personal type. To stop bookings on the last one, update it with isEnabled: false instead. Members delete their own personal types. Another member's type and every team type need the members permission.
Errors:
403 forbidden: you need thememberspermission for another member's type or a team type.403 permission_denied: Client seats cannot delete meeting types.404 not_found: no live meeting type has this id in the workspace.409 invalid_state: this is the member's only personal type (last_personal_type).
Requires Meetings view.
curl -X DELETE "https://api.ken.so/v1/meeting-types/812" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 204
HTTP/1.1 204 No ContentList a meeting type's open times
/v1/meeting-types/{meetingTypeId}/slotsmeeting-types.slots- Permission
- Calendar view
- Rate limit
- 12,000 requests a minute per API key
scheduler feature on your workspace. Until it is on, calls answer 404.Lists the start times someone could book on a meeting type between from and to. Kenso reads the host's calendar and applies the type's hours, minimum notice, booking window, buffers and daily cap. A round_robin type offers a time when any bookable host is free, and a collective type when every host is.
from and to are required ISO 8601 instants, at most 31 days apart, and bound each slot's start. timeZone is an IANA time zone, such as America/New_York, for each slot's localStartAt. Leave it out to use the host's zone.
status is available with slots, no_availability when the range has no open time, or unavailable with a reason: host_not_member, calendar_not_connected, calendar_needs_reconnect, calendar_provider_error or meeting_type_disabled.
Errors:
400 validation_failed:fromortois missing,tois not afterfrom, the range is longer than 31 days, ortimeZoneis not an IANA time zone.403 forbidden: the API key is not tied to a member of the workspace.404 not_found: no live meeting type has this id in the workspace.
Requires Meetings view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from | query | string (date-time) | optional | Earliest slot start to return, as an ISO 8601 timestamp such as 2026-11-10T00:00:00Z. Required. |
to | query | string (date-time) | optional | Kenso returns slots that start before this time, an ISO 8601 timestamp. Required, after from and at most 31 days later. |
timeZone | query | string | optional | IANA time zone for each slot's localStartAt, such as America/New_York. Omitted uses the host's time zone. |
curl -X GET "https://api.ken.so/v1/meeting-types/812/slots" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a MeetingTypeSlots.
Show the 8 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
More in Meetings and calls:Booking linksBookingsExternal bookingsMeeting briefsCallingAll resources