Skip to Content
Meetings and calls

Meeting types

The meetings people can book with you.

Meetings and calls6 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

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.

NameInTypeRequiredDescription
meetingTypeIdpathinteger (int64)requiredThe meeting type's id.

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe 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-Idheaderinteger (int64)optionalThe 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

GET/v1/meeting-typesmeeting-types.list
Permission
Calendar view
Rate limit
12,000 requests a minute per API key
Needs the scheduler feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

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: kind holds 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

NameInTypeRequiredDescription
ownerMemberIdqueryinteger (int64)optionalOnly meeting types this member owns, by member id. Team types have no owner, so this filter leaves them out.
kindquerystringoptionalOnly these kinds, as a comma-separated list of personal, round_robin and collective. Omitted returns every kind.
hostMemberIdqueryinteger (int64)optionalOnly team types that list this member as a host, by member id. Personal types never match.
limitqueryinteger (int32)optionalNumber of meeting types per page, from 1 to 200. Default 50.
cursorquerystringoptionalThe nextCursor from the previous page. Omit it for the first page.
Request
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

POST/v1/meeting-typesmeeting-types.create
Permission
Calendar view
Rate limit
4,800 requests a minute per API key
Needs the scheduler feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

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 in details names the field by its path, such as availability.weekly.monday[0].end.
  • 402 plan_limit_reached: team types need a paid plan.
  • 403 forbidden: you need the members permission for another member's type or a team type.
  • 403 permission_denied: Client seats cannot create meeting types.
  • 404 not_found: ownerMemberId is 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.

FieldTypeRequiredDescription
lengthMinutesinteger (int32)optionalHow long the meeting lasts, 5 to 720 minutes. Cannot be null.
locationKindstringoptionalWhere 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.
locationDetailstringoptionalThe address, link or instructions, up to 500 characters. Required for in_person and custom, refused for a conference tool. Null clears it.
minimumNoticeMinutesinteger (int32)optionalHow soon before a meeting it can still be booked, 0 to 43,200 minutes (30 days). Cannot be null.
bookingWindowDaysinteger (int32)optionalHow far ahead people can book, 1 to 365 days. Cannot be null.
bufferBeforeMinutesinteger (int32)optionalFree time kept before each meeting, 0 to 240 minutes. Cannot be null.
bufferAfterMinutesinteger (int32)optionalFree time kept after each meeting, 0 to 240 minutes. Cannot be null.
dailyCapinteger (int32)optionalThe most bookings a host takes in a day, 1 to 100. Null turns the cap off.
reminderEnabledbooleanoptionalWhether the booker gets a reminder email 24 hours before the meeting. Cannot be null.
reminderTextstringoptionalYour own text for the reminder email, up to 2,000 characters. Null clears it, and the reminder uses Kenso's text.
questionsarray of MeetingTypeQuestionInputoptionalUp to 5 questions the booker answers, replacing the whole list. Null removes every question.
namestringoptionalThe type's name, 1 to 100 characters. Required on create. Cannot be null.
slugstringoptionalThe 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.
descriptionstringoptionalWhat the booker reads about the meeting, up to 2,000 characters. Null clears it.
isSecretbooleanoptionalWhether the type is secret: bookable by its link but not listed on the member's booking page.
isEnabledbooleanoptionalWhether people can book the type. False turns it off without deleting it.
isDefaultbooleanoptionalSend true to make this the owner's default type. To move the default, send true on the new default type.
availabilityAvailabilityScheduleoptionalThe 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.
kindstringoptionalThe kind of type: personal (the default), round_robin or collective. Team kinds need the members permission and a paid plan.
ownerMemberIdinteger (int64)optionalThe member who owns a personal type. Defaults to you; another member needs the members permission.
hostMemberIdsarray of integer (int64)optionalFor 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.
Request
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

GET/v1/meeting-types/{meetingTypeId}meeting-types.get
Permission
Calendar view
Rate limit
12,000 requests a minute per API key
Needs the scheduler feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

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.

Request
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

PATCH/v1/meeting-types/{meetingTypeId}meeting-types.update
Permission
Calendar view
Rate limit
4,800 requests a minute per API key
Needs the scheduler feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

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, isDefault is false or null, or hostMemberIds was sent for a personal type.
  • 402 plan_limit_reached: turning a team type on needs a paid plan.
  • 403 forbidden: you need the members permission 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.

FieldTypeRequiredDescription
lengthMinutesinteger (int32)optionalHow long the meeting lasts, 5 to 720 minutes. Cannot be null.
locationKindstringoptionalWhere 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.
locationDetailstringoptionalThe address, link or instructions, up to 500 characters. Required for in_person and custom, refused for a conference tool. Null clears it.
minimumNoticeMinutesinteger (int32)optionalHow soon before a meeting it can still be booked, 0 to 43,200 minutes (30 days). Cannot be null.
bookingWindowDaysinteger (int32)optionalHow far ahead people can book, 1 to 365 days. Cannot be null.
bufferBeforeMinutesinteger (int32)optionalFree time kept before each meeting, 0 to 240 minutes. Cannot be null.
bufferAfterMinutesinteger (int32)optionalFree time kept after each meeting, 0 to 240 minutes. Cannot be null.
dailyCapinteger (int32)optionalThe most bookings a host takes in a day, 1 to 100. Null turns the cap off.
reminderEnabledbooleanoptionalWhether the booker gets a reminder email 24 hours before the meeting. Cannot be null.
reminderTextstringoptionalYour own text for the reminder email, up to 2,000 characters. Null clears it, and the reminder uses Kenso's text.
questionsarray of MeetingTypeQuestionInputoptionalUp to 5 questions the booker answers, replacing the whole list. Null removes every question.
namestringoptionalThe type's name, 1 to 100 characters. Required on create. Cannot be null.
slugstringoptionalThe 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.
descriptionstringoptionalWhat the booker reads about the meeting, up to 2,000 characters. Null clears it.
isSecretbooleanoptionalWhether the type is secret: bookable by its link but not listed on the member's booking page.
isEnabledbooleanoptionalWhether people can book the type. False turns it off without deleting it.
isDefaultbooleanoptionalSend true to make this the owner's default type. To move the default, send true on the new default type.
availabilityAvailabilityScheduleoptionalThe 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.
hostMemberIdsarray of integer (int64)optionalFor team types only: the whole ordered host list. A host already on the type can stay while their calendar needs reconnecting.
Request
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

DELETE/v1/meeting-types/{meetingTypeId}meeting-types.delete
Permission
Calendar view
Rate limit
4,800 requests a minute per API key
Needs the scheduler feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

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 the members permission 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.

Request
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

Response 204
HTTP/1.1 204 No Content

List a meeting type's open times

GET/v1/meeting-types/{meetingTypeId}/slotsmeeting-types.slots
Permission
Calendar view
Rate limit
12,000 requests a minute per API key
Needs the scheduler feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

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: from or to is missing, to is not after from, the range is longer than 31 days, or timeZone is 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

NameInTypeRequiredDescription
fromquerystring (date-time)optionalEarliest slot start to return, as an ISO 8601 timestamp such as 2026-11-10T00:00:00Z. Required.
toquerystring (date-time)optionalKenso returns slots that start before this time, an ISO 8601 timestamp. Required, after from and at most 31 days later.
timeZonequerystringoptionalIANA time zone for each slot's localStartAt, such as America/New_York. Omitted uses the host's time zone.
Request
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.


On this page