Kenso API changes on 2026-11-03
Every change on this day, by version. The changelog lists the newest days and links the older ones.
Version 2026-11-02
2026-11-03 71 changes
- Changed
Documentation fix: the reference no longer lists workspaceName on infra findings. It was never part of the customer API: only Kenso's own findings list fills it, so no request or response changed. - Changed
Documentation fix: the reference no longer lists tenantHost on inboxes, enrollmentFailure on inbox warmup, or the emailsFoundByKen field of contact imports. They were never part of the customer API: the API never returned the first two to a workspace and refuses emailsFoundByKen=true from one, so no request or response changed. - Changed
Documentation fix: query parameters in this reference are now named in camelCase (limit, cursor, campaignId), as request and response fields already were. The API has always read query parameter names in any case, so no request changes. - Changed
threads.create-message
Added optional request field delaySeconds to threads.create-message: an email reply's undo window, 60 (the default when omitted) or 300, as on threads.forward; any other value is 400 validation_failed, and a LinkedIn reply sends at once and ignores it. Added optional field data.scheduledMessageId to the 201 response: the queued email reply's scheduled message, which POST /v1/scheduled-messages/{id}/cancel takes until the window ends. subject is documented as drafts only: a reply goes out on the thread's subject, and a send never read it. - Changed
threads.create
Added optional fielddata.scheduledMessageIdto the threads.create response. It is filled only on the threads.create-message 201 response and omitted on this response. - Changed
threads.list-messages
Added optional fielddata[].scheduledMessageIdto the threads.list-messages response. It is filled only on the threads.create-message 201 response and omitted on this response. - Changed
contacts.get
The contact now carries two optional read-only fields. dataFlags is an object of flags about the contact's data by name, as stored, such as previousEmployerEmail (a found work email is on a previous employer's domain) or jobChange (the person moved to a new company), each with currentCompanyDomain and detectedAt; new names can appear, and it is {} when there are none. personalEmails lists the personal addresses a data provider found for the person, newest first, each with email, source (such as loopster) and foundAt; it is [] when there are none. Personal emails are for the person reading the contact: Kenso never sends to, verifies or exports them. Only this read returns the two fields; contacts.list, contacts.search and contacts.update do not. - Changed
campaigns.archive
Added optional fielddata.linkedInOnlyto the campaigns.archive response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.create
Added optional fielddata.linkedInOnlyto the campaigns.create response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.duplicate
Added optional fielddata.linkedInOnlyto the campaigns.duplicate response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.get
Added optional fielddata.linkedInOnlyto the campaigns.get response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.launch
Added optional fielddata.linkedInOnlyto the campaigns.launch response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.list
Added optional fielddata[].linkedInOnlyto the campaigns.list response. True when the campaign is LinkedIn-only. - Changed
campaigns.pause
Added optional fielddata.linkedInOnlyto the campaigns.pause response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.restart
Added optional fielddata.linkedInOnlyto the campaigns.restart response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.resume
Added optional fielddata.linkedInOnlyto the campaigns.resume response. It is filled only on campaigns.list items and omitted on this response. - Changed
campaigns.update
Added optional fielddata.linkedInOnlyto the campaigns.update response. It is filled only on campaigns.list items and omitted on this response. - Added
contact-behavior.get
Added GET /v1/contacts/{contactId}/behavior: what Kenso learned about the person behind a contact from outreach outcomes. workspace holds this workspace's tags (such as cold_responder, prefers_linkedin, best_window:weekday_morning, away_until:2026-11-18), signal records {key, value, rate, touches, responses}, touches and computedAt; network holds the same from every Kenso workspace, anonymous, plus workspaces (how many other workspaces touched the person), only where the workspace has network signals on. Absent means null, and a contact with no profile returns an empty object. Answers not_found until behavior signals are on for the workspace. - Changed
contacts.get
Each contact can now carry the optional field customVideo, the lead's own video when it has one: status (pending, ready or failed), provider, source, watchUrl, previewUrl and previewExpiresAt (a short-lived thumbnail preview) and error. It is present only when campaign videos are on for the workspace, which are in early access. Existing fields are unchanged. - Changed
contacts.list
Each contact in the list can now carry the optional field customVideo, the lead's own video when it has one: status (pending, ready or failed), provider, source, watchUrl, previewUrl and previewExpiresAt (a short-lived thumbnail preview) and error. It is present only when campaign videos are on for the workspace, which are in early access. Existing fields are unchanged. - Changed
contacts.search
Each contact in the results can now carry the optional field customVideo, the lead's own video when it has one: status (pending, ready or failed), provider, source, watchUrl, previewUrl and previewExpiresAt (a short-lived thumbnail preview) and error. It is present only when campaign videos are on for the workspace, which are in early access. Existing fields are unchanged. - Changed
contacts.update
Added the optional request field customVideo, the lead's own video: a Loom, YouTube, Vimeo, Wistia, Vidyard, Sendspark or HeyGen share link or embed code. Empty or null clears it. The contact must be in a campaign. A video a sent or queued step already uses cannot change: 409 video_in_use. The response carries customVideo as on contacts.get. It needs campaign videos on the workspace, which are in early access. - Changed
contacts.bulk-update
Each item accepts the optional field customVideo, with the same rules as contacts.update. An item whose video a sent or queued step already uses gets the status video_in_use. It needs campaign videos on the workspace, which are in early access. - Changed
contacts.create
Each contact accepts the optional field customVideo, the lead's own video as a share link or embed code. An empty string clears it. A video a sent or queued step already uses fails its row with code video_in_use, and the contact is still saved. It needs campaign videos on the workspace, which are in early access. - Changed
contact-imports.scan
Added optional fieldsavedListKindto the contact-imports.scan request. With target saved_list, send people or companies instead of savedListId to check a file for a list not created yet: rows are read and keyed as a new list of that kind reads them, nothing is on the list yet so duplicateInList is 0, and willAdd is the rows the new list gets. Send exactly one of savedListId and savedListKind, else 400. - Changed
linkedin-sequences.get
Added optional field data.steps[].voice: a voice_note step's voice settings (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage). - Changed
linkedin-sequences.get-version
Added optional field data.steps[].voice: a voice_note step's voice settings, as linkedin-sequences.get returns them. - Changed
linkedin-sequences.replace
Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Changed
linkedin-sequences.save-version
Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.sequence.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Changed
segment-linkedin-sequences.get
Added optional field data.steps[].voice: a voice_note step's voice settings, as linkedin-sequences.get returns them. - Changed
segment-linkedin-sequences.get-version
Added optional field data.steps[].voice: a voice_note step's voice settings, as linkedin-sequences.get returns them. - Changed
segment-linkedin-sequences.replace
Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Changed
segment-linkedin-sequences.save-version
Added optional field steps[].voice (provider, voiceId, speed, wordsMode, instructions, script, model, matchLeadLanguage): the voice settings of a voice_note LinkedIn step, the AI voice note Ken writes and speaks for each lead. The response returns it on data.sequence.steps[].voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Changed
threads.create
Added optional field data.voiceNote to the response: the voice note a LinkedIn message carries (voiceNoteId, status, durationMs, provider, voiceId, language, scriptText, audioAvailable, audioUrl, failureReason). - Changed
threads.create-message
Added optional field data.voiceNote to the 201 response: the voice note a LinkedIn message carries, as threads.list-messages returns it. - Changed
threads.list-messages
Added optional field data[].voiceNote: the voice note a LinkedIn message carries (voiceNoteId, status, durationMs, provider, voiceId, language, scriptText, audioAvailable, audioUrl, failureReason). A voice note Kenso did not send has no voiceNoteId. - Added
voice-note-previews.create
Added POST /v1/voice-note-previews: preview a voice_note step for up to 3 leads of a campaign, 15 leads a day per workspace. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Added
voice-notes.audio
Added GET /v1/voice-notes/{voiceNoteId}/audio: a 302 to a one-hour link to a voice note's audio. Requires Inbox view. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Added
voices.import
Added POST /v1/voices: import an ElevenLabs voice from the workspace's own ElevenLabs account. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Added
voices.list
Added GET /v1/voices: the Deepgram and ElevenLabs voices a voice_note step can use, with samples. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Added
voices.list-importable
Added GET /v1/voices/importable: the voices on the workspace's ElevenLabs account that it can import. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Added
voices.remove
Added DELETE /v1/voices/{provider}/{voiceId}: remove an imported voice. Needs the linkedin_voice_notes feature, which is off for every workspace for now. - Changed
threads.create
Added optional field browserRun to the threads.create response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - Changed
threads.create-message
Added optional field browserRun to the threads.create-message 201 response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - Changed
threads.get
Added optional field browserRun to the threads.get response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - Changed
threads.list
Added optional field browserRun to each thread in the threads.list response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - Changed
threads.list-messages
Added optional field browserRun to each message in the threads.list-messages response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - Changed
threads.update
Added optional field browserRun to the threads.update response: set when the mail came from a site a workflow's browser step submitted a form to (DEV-6958). runId names that browser run, and automated is true for the site's own automatic mail rather than a person's reply. It is omitted on every other thread. - Changed
contact-imports.scan
Added optional fieldsavedListIdto the contact-imports.scan request. With target saved_list it runs the List check against one of the workspace's own saved lists: rows already on the list, duplicates inside the file, the workspace blocklist and Kenso's email checks. For a saved list, keys.cleanup defaults to false, as the list's upload does. A saved_list scan also needs Search view and the saved lists feature. - Changed
contact-imports.create
Added optional fields records and searchId to the contact-imports.create request, for source loopster: records holds 1 to 1,000 people picked in the Loopster tab of Search (each record's id, position and fields, as the search returned it), and searchId is the meta.searchId of that search, needed when a picked record has no linkedInUrl. - Changed
saved-list-members.list
Added optional field data[].photoUrl to the saved-list-members.list response: the member's profile photo, as saved-lists.list-members returns it. - Changed
saved-lists.list-members
Added optional field data[].photoUrl to the saved-lists.list-members response: the member's profile photo, saved when the member is added or refreshed from a Search or campaign source. It is omitted when there is no photo, for a LinkedIn placeholder image, or for an expired photo link. - Changed
segments.activate
Added optional fieldsdata.filterCriteria.behaviorTagsanddata.filterCriteria.behaviorTagsExcludeto the segments.activate response. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.create
Added optional fieldsfilterCriteria.behaviorTagsandfilterCriteria.behaviorTagsExcludeto the segments.create request. Added optional fieldsdata.filterCriteria.behaviorTagsanddata.filterCriteria.behaviorTagsExcludeto the segments.create response. behaviorTags keeps contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude drops contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.deactivate
Added optional fieldsdata.filterCriteria.behaviorTagsanddata.filterCriteria.behaviorTagsExcludeto the segments.deactivate response. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.get
Added optional fieldsdata.filterCriteria.behaviorTagsanddata.filterCriteria.behaviorTagsExcludeto the segments.get response. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.get-version
Added optional fieldsdata.snapshot.filterCriteria.behaviorTagsanddata.snapshot.filterCriteria.behaviorTagsExcludeto the segments.get-version response. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.list
Added optional fieldsdata[].filterCriteria.behaviorTagsanddata[].filterCriteria.behaviorTagsExcludeto the segments.list response. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.preview
Added optional fieldsbehaviorTagsandbehaviorTagsExcludeto the segments.preview request. behaviorTags previews the contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude leaves out contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. - Changed
segments.restore-version
Added optional fieldsdata.snapshot.filterCriteria.behaviorTagsanddata.snapshot.filterCriteria.behaviorTagsExcludeto the segments.restore-version response. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.save-version
Added optional fieldsfilterCriteria.behaviorTagsandfilterCriteria.behaviorTagsExcludeto the segments.save-version request. Added optional fieldsdata.segment.filterCriteria.behaviorTagsanddata.segment.filterCriteria.behaviorTagsExcludeto the segments.save-version response. behaviorTags keeps contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude drops contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. They echo the segment's behavior tag criteria, unset when the segment has none. - Changed
segments.update
Added optional fieldsfilterCriteria.behaviorTagsandfilterCriteria.behaviorTagsExcludeto the segments.update request. Added optional fieldsdata.filterCriteria.behaviorTagsanddata.filterCriteria.behaviorTagsExcludeto the segments.update response. behaviorTags keeps contacts whose behavior tags include any of these (what Kenso learned from outreach outcomes, e.g. cold_responder or prefers_linkedin), and behaviorTagsExclude drops contacts that carry any of them. Each takes up to 50 tags; email_confirmed, email_dead_end and left_company cannot be filtered. Workspace tags always count, network tags only with the behavior_signals_network feature. They echo the segment's behavior tag criteria, unset when the segment has none. - Added
threads.counts
Added optional query parameter GroupBy to threads.counts. - Added
threads.list
Added optional query parameter GroupBy to threads.list. Added optional query parameter PersonKey to threads.list. - Added
threads.list-messages
Added optional query parameter includeEvents to threads.list-messages.
Optional fields added on 6 operations
- Changed
contacts.create
Added optional fieldcontacts[].useKenEmailto the contacts.create request. - Changed
people.intake
Added optional fielduseKenEmailto the people.intake request. - Changed
threads.list
Added optional fieldsdata[].channels,data[].channels.email,data[].channels.linkedin,data[].personId,data[].personKey,data[].personName,data[].threadIdsanddata[].waitingCountto the threads.list response. - Changed
threads.create
Added optional fielddata.kindto the threads.create response. - Changed
threads.create-message
Added optional fielddata.kindto the threads.create-message 201 response. - Changed
threads.list-messages
Added optional fielddata[].kindto the threads.list-messages response.