Skip to Content

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.

35 changesRSS feed
Markdown

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 field data.phoneCountryAssumed to the contacts.get response.
  • Changed contacts.list
    Added optional field data[].phoneCountryAssumed to the contacts.list response.
  • Changed contacts.search
    Added optional field data[].phoneCountryAssumed to the contacts.search response.
  • Changed contacts.update
    Added optional field data.phoneCountryAssumed to the contacts.update response.
  • Changed campaigns.archive
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.archive response.
  • Changed campaigns.create
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.create response.
  • Changed campaigns.duplicate
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.duplicate response.
  • Changed campaigns.get
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.get response.
  • Changed campaigns.launch
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.launch response.
  • Changed campaigns.list
    Added optional fields data[].catchAllLaneEnabled and data[].catchAllLanePausedAt to the campaigns.list response.
  • Changed campaigns.pause
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.pause response.
  • Changed campaigns.restart
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.restart response.
  • Changed campaigns.resume
    Added optional fields data.catchAllLaneEnabled and data.catchAllLanePausedAt to the campaigns.resume response.

More