Kenso API changes on 2026-11-02
Every change on this day, by version. The changelog lists the newest days and links the older ones.
Version 2026-11-02
2026-11-02 35 changes
- Added
saved-list-members.list
Added GET /v1/saved-list-members: search the people and companies on the workspace's own saved lists and lists shared with it (never library lists) by name, title or company with q (2-200 characters). Each result is a member as saved-lists.list-members shows it, plus savedListId, savedListName and savedListKind; a person on two lists comes back once per list. Cursor pagination, no total; a page can hold fewer results than limit, even none, with hasMore true, so keep paging with nextCursor. - Changed
saved-lists.list-members
Added the optional q parameter: matches a part of a member's full name, title or company name, any case. Up to 200 characters; shorter than 2 is ignored. With q, includeTotal counts the matches. - Changed
Documentation fix: enum fields in this reference now show the string values the API has always sent and accepted (for example "active"), not integer codes. No request or response changed. - Changed
threads.bulk-update
Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - Changed
threads.mark-all-read
Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - Changed
threads.update
Accepts an optional Idempotency-Key header (at most 200 characters, per workspace). A retry with the same key and the same request within 24 hours returns the first response, with Idempotent-Replayed: true, and does not run the write again. The same key with a different request is 422 idempotency_key_reused. - Changed
search.search-people
Added the optional view query parameter to search.search-people. view=summary returns each person with only the fields a list shows (names, headline, LinkedIn URL, photo, current title and company, location, seniority, function, job-change signals, hasKenEmail, kenEmailStatus, lookalike), about 1-2 KB a person instead of 17-28 KB. Without view, or with view=full, the response is unchanged. - Changed
triggers.list-linkedin-engagements
Each LinkedIn engagement in the list now carries optional fields: reactionType for a reaction, commentId and parentCommentId for a comment or a reply under one, postText, an intent label on comments and replies (requesting, positive, question, neutral or negative) with its intentReason, and ownPost, which is false when the post was pasted in and is not by a connected seat or your company page. Existing fields are unchanged. - Added
cli-logins.create
Added cli-logins.create, which starts a Kenso CLI browser login and returns the code to approve. It answers 404 until Kenso CLI browser login is turned on. - Added
cli-logins.token
Added cli-logins.token, which the Kenso CLI polls until its browser login is approved, denied or expired. It answers 404 until Kenso CLI browser login is turned on. - Changed
contacts.create
The response adds data.results: one item per submitted contact, in request order, with its index, status (created, updated, skipped or failed), the contact id when saved, a reason and message when not, and sendable. succeeded and failed are unchanged. - Changed
contacts.update
Documented the request body. customVariables merges into the contact's custom variables; a null or empty value removes that key. - Changed
contacts.bulk-update
Documented the items: each is a contactId (required) plus any field contacts.update accepts, customVariables included. - Changed
contacts.bulk-delete
The response schema it shares with contacts.create now lists data.results. Only contacts.create fills it, so this operation's responses do not change. - Changed
contacts.bulk-pause
The response schema it shares with contacts.create now lists data.results. Only contacts.create fills it, so this operation's responses do not change. - Changed
contacts.bulk-resume
The response schema it shares with contacts.create now lists data.results. Only contacts.create fills it, so this operation's responses do not change. - Changed
contact-imports.create
Documented the JSON and multipart request bodies: source, target, contacts, columnMappings, the uploaded file and the import options. The endpoint already accepted these fields. - Changed
contact-exports.create
Documented the request body: kind, the campaign, segment and workspace filters, fields and the events range. The endpoint already accepted these fields. - Changed
campaigns.update
Added optional field catchAllLaneEnabled to the campaigns.update request: true opts the campaign in to the catch-all lane (off by default, and no effect until Kenso turns the lane on). Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.update response. - Added
search.list-lookalike-seeds
Added the optional campaignId, since and stage query parameters to search.list-lookalike-seeds. campaignId is required with source campaign and filters interested and replies; since (a day as YYYY-MM-DD, UTC) counts only replies or visits on or after it for interested, replies and website_visitors; stage picks the CRM deals for source crm: won (default), open or any. - Changed
contacts.events
Added optional field data[].kind to the contacts.events response: on a video_event row, which video activity it is (video_viewed, video_played, video_watched, video_liked or video_cta_clicked). Omitted on every other row. - Added
First dated version of the Kenso API. Its shapes are identical to Ken-Version: 1.1, which stays an alias of this version. Send Ken-Version: 2026-11-02 and your integration keeps these shapes until the version retires, 12 months after the next version ships. A request without the header uses the version its API key is pinned to.
Optional fields added on 13 operations
- Changed
contacts.get
Added optional fielddata.phoneCountryAssumedto the contacts.get response. - Changed
contacts.list
Added optional fielddata[].phoneCountryAssumedto the contacts.list response. - Changed
contacts.search
Added optional fielddata[].phoneCountryAssumedto the contacts.search response. - Changed
contacts.update
Added optional fielddata.phoneCountryAssumedto the contacts.update response. - Changed
campaigns.archive
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.archive response. - Changed
campaigns.create
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.create response. - Changed
campaigns.duplicate
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.duplicate response. - Changed
campaigns.get
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.get response. - Changed
campaigns.launch
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.launch response. - Changed
campaigns.list
Added optional fieldsdata[].catchAllLaneEnabledanddata[].catchAllLanePausedAtto the campaigns.list response. - Changed
campaigns.pause
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.pause response. - Changed
campaigns.restart
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.restart response. - Changed
campaigns.resume
Added optional fieldsdata.catchAllLaneEnabledanddata.catchAllLanePausedAtto the campaigns.resume response.