Skip to Content
Meetings and calls

Bookings

Booked meetings: read, reschedule and cancel.

Meetings and calls5 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
bookingIdpathinteger (int64)requiredThe booking'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 bookings

GET/v1/bookingsbookings.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 bookings you can see, ordered by start time.

Combine any of these filters: hostMemberId, organizerMemberId, status (confirmed, rescheduled, cancelled or no_show, several separated by commas), startAfter (starts at or after this time), startBefore (starts before this time), campaignId, personId and accountId. A filter only narrows what you can see. Page with limit, from 1 to 200 (default 50), and the cursor from pagination.nextCursor.

Errors:

  • 400 validation_failed: status holds an unknown value, startBefore is not after startAfter, limit is out of range, or cursor is not valid.
  • 403 forbidden: the API key is not tied to a member of the workspace.

Requires Meetings view.

Parameters

NameInTypeRequiredDescription
limitqueryinteger (int32)optionalNumber of bookings per page, from 1 to 200. Default 50.
cursorquerystringoptionalThe nextCursor from the previous page. Omit it for the first page.
hostMemberIdqueryinteger (int64)optionalOnly bookings this member hosts, by member id.
organizerMemberIdqueryinteger (int64)optionalOnly bookings this member organizes, by member id. It never shows a booking you could not see without it.
statusquerystringoptionalOnly bookings in these statuses, as a comma-separated list of confirmed, rescheduled, cancelled and no_show. Omitted returns every status.
startAfterquerystring (date-time)optionalOnly bookings that start at or after this time, an ISO 8601 timestamp.
startBeforequerystring (date-time)optionalOnly bookings that start before this time, an ISO 8601 timestamp. With startAfter, it must be later than startAfter.
campaignIdqueryinteger (int64)optionalOnly bookings credited to this campaign.
personIdqueryinteger (int64)optionalOnly bookings linked to this person, by the booking's personId.
accountIdqueryinteger (int64)optionalOnly bookings linked to this account, by the booking's accountId.
Request
curl -X GET "https://api.ken.so/v1/bookings?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 Booking. Each item has these fields. The response also carries pagination.

Show the 28 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Get a booking

GET/v1/bookings/{bookingId}bookings.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 booking you can see.

Errors:

  • 403 forbidden: the API key is not tied to a member of the workspace.
  • 404 not_found: the booking is not in this workspace, or you cannot see it.

Requires Meetings view.

Request
curl -X GET "https://api.ken.so/v1/bookings/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 Booking.

Show the 28 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Reassign a former member's bookings

POST/v1/bookings/bulk-reassignbookings.bulk-reassign
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

Moves the upcoming bookings of a member who left the workspace to other members, 20 bookings per call. Call it again with nextCursor as cursor while hasMore is true.

Send hostMemberId, the id of the member who left. For each booking, Kenso looks for a member who is free at the same time, in this order: the account owner, the campaign's sender, the meeting type's other hosts, then any member with a personal meeting type that is turned on. The new host's calendar sends the booker a new invite, and Kenso then removes the old event from the former member's calendar. Kenso does not move a collective meeting: cancel it, or rebook it by hand.

The response counts succeeded and failed and has one entry in results per booking, in start order. A booking that ends with host_busy or calendar_write_failed is unchanged, so the next call with the same cursor tries it again.

Errors:

  • 400 validation_failed: hostMemberId is missing, or cursor is not valid.
  • 403 forbidden: you need the members permission.
  • 403 permission_denied: Client seats cannot reassign bookings.
  • 409 invalid_state: the person is still a member of the workspace. Remove them first.

Requires Meetings view.

Request body

application/json, optional.

FieldTypeRequiredDescription
hostMemberIdinteger (int64)requiredRequired. The former member whose upcoming bookings to handle.
cursorstringoptionalThe nextCursor from the previous call; leave it out on the first call.
Request
curl -X POST "https://api.ken.so/v1/bookings/bulk-reassign" \
  -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 '{
  "hostMemberId": 812,
  "cursor": "eyJpZCI6ODE1fQ"
}'

Response 200

data is a BookingLeaverResult.

Show the 5 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Cancel a former member's bookings

POST/v1/bookings/bulk-cancelbookings.bulk-cancel
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

Cancels the upcoming bookings of a member who left the workspace, 20 bookings per call. Call it again with nextCursor as cursor while hasMore is true.

Send hostMemberId, the id of the member who left. For each booking, Kenso removes the event from the former member's calendar and cancels the booking on behalf of the workspace. The booker learns of the cancel only when the event is removed, and then calendarEventRemoved is true. When the invite stayed on the former member's calendar, the entry has status: cancelled, errorCode: booker_not_told and an error, and it counts in failed: tell the booker yourself.

The response has the same shape as bulk reassign. Each entry's status is cancelled, already_handled, host_busy, calendar_write_failed or failed.

Errors:

  • 400 validation_failed: hostMemberId is missing, or cursor is not valid.
  • 403 forbidden: you need the members permission.
  • 403 permission_denied: Client seats cannot cancel bookings in bulk.
  • 409 invalid_state: the person is still a member of the workspace. Remove them first.

Requires Meetings view.

Request body

application/json, optional.

FieldTypeRequiredDescription
hostMemberIdinteger (int64)requiredRequired. The former member whose upcoming bookings to handle.
cursorstringoptionalThe nextCursor from the previous call; leave it out on the first call.
Request
curl -X POST "https://api.ken.so/v1/bookings/bulk-cancel" \
  -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 '{
  "hostMemberId": 812,
  "cursor": "eyJpZCI6ODE1fQ"
}'

Response 200

data is a BookingLeaverResult.

Show the 5 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Mark a booking as a no-show

POST/v1/bookings/{bookingId}/no-showbookings.no-show
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

Marks a confirmed booking whose start time has passed as a no-show. The host, the organizer, or a member with the members permission who can see the booking may mark it.

Kenso adds a no-show event to the meeting's timeline and puts a "Sorry we missed you" draft with a new single-use booking link in Today for approval. Marking a booking that is already a no-show changes nothing and returns it.

Errors:

  • 403 forbidden: the API key is not tied to a member of the workspace.
  • 403 permission_denied: Client seats cannot mark no-shows.
  • 404 not_found: the booking is not in this workspace, you cannot see it, or you may not mark it.
  • 409 invalid_state: the booking has not started yet, or it is cancelled or rescheduled.

Requires Meetings view.

Request
curl -X POST "https://api.ken.so/v1/bookings/812/no-show" \
  -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 Booking.

Show the 28 response fields and an example

The fields and an example are also on this endpoint's Markdown page.


On this page