Bookings
Booked meetings: read, reschedule and cancel.
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 |
|---|---|---|---|---|
bookingId | path | integer (int64) | required | The booking'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 bookings
/v1/bookingsbookings.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 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:statusholds an unknown value,startBeforeis not afterstartAfter,limitis out of range, orcursoris not valid.403 forbidden: the API key is not tied to a member of the workspace.
Requires Meetings view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
limit | query | integer (int32) | optional | Number of bookings per page, from 1 to 200. Default 50. |
cursor | query | string | optional | The nextCursor from the previous page. Omit it for the first page. |
hostMemberId | query | integer (int64) | optional | Only bookings this member hosts, by member id. |
organizerMemberId | query | integer (int64) | optional | Only bookings this member organizes, by member id. It never shows a booking you could not see without it. |
status | query | string | optional | Only bookings in these statuses, as a comma-separated list of confirmed, rescheduled, cancelled and no_show. Omitted returns every status. |
startAfter | query | string (date-time) | optional | Only bookings that start at or after this time, an ISO 8601 timestamp. |
startBefore | query | string (date-time) | optional | Only bookings that start before this time, an ISO 8601 timestamp. With startAfter, it must be later than startAfter. |
campaignId | query | integer (int64) | optional | Only bookings credited to this campaign. |
personId | query | integer (int64) | optional | Only bookings linked to this person, by the booking's personId. |
accountId | query | integer (int64) | optional | Only bookings linked to this account, by the booking's accountId. |
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
/v1/bookings/{bookingId}bookings.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 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.
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
/v1/bookings/bulk-reassignbookings.bulk-reassign- 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.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:hostMemberIdis missing, orcursoris not valid.403 forbidden: you need thememberspermission.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.
| Field | Type | Required | Description |
|---|---|---|---|
hostMemberId | integer (int64) | required | Required. The former member whose upcoming bookings to handle. |
cursor | string | optional | The nextCursor from the previous call; leave it out on the first call. |
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
/v1/bookings/bulk-cancelbookings.bulk-cancel- 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.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:hostMemberIdis missing, orcursoris not valid.403 forbidden: you need thememberspermission.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.
| Field | Type | Required | Description |
|---|---|---|---|
hostMemberId | integer (int64) | required | Required. The former member whose upcoming bookings to handle. |
cursor | string | optional | The nextCursor from the previous call; leave it out on the first call. |
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
/v1/bookings/{bookingId}/no-showbookings.no-show- 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.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.
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.
More in Meetings and calls:Meeting typesBooking linksExternal bookingsMeeting briefsCallingAll resources