Kenso API changes on 2026-11-15
Every change on this day, by version. The changelog lists the newest days and links the older ones.
Version 2026-11-02
2026-11-15 84 changes
- Added
sandboxes.create
Added sandboxes.create (POST /v1/sandboxes): creates your developer sandbox, a workspace where sends, orders and charges are simulated, and returns it with one test key (kenso_test_). One sandbox per member. Available where developer sandboxes are turned on. - Added
sandboxes.get
Added sandboxes.get (GET /v1/sandboxes/{sandboxId}): reads your developer sandbox. Available where developer sandboxes are turned on. - Added
sandboxes.list
Added sandboxes.list (GET /v1/sandboxes): lists your developer sandbox, zero or one. Available where developer sandboxes are turned on. - Changed
job-post-searches.count
The job-post-searches.count response is now documented field by field: totalResults and hiringSet. The answer itself is unchanged. - Changed
job-post-searches.people
The job-post-searches.people response is now documented field by field: the people page, each person's jobPost, hiringSet and, with companyIds, companies. The answer itself is unchanged. - Changed
search.expand-titles
The search.expand-titles response is now documented field by field: expandedTitles and error. The answer itself is unchanged. - Changed
search.get-people-facets
The search.get-people-facets response is now documented field by field: each facet's values with their counts. The answer itself is unchanged. - Changed
search.get-person
The search.get-person response is now documented field by field: the whole person record, with hasKenEmail, kenEmailStatus and searchToken. The answer itself is unchanged. - Changed
search.lookup-person
The search.lookup-person response is now documented field by field: the whole person record, with hasKenEmail, kenEmailStatus and searchToken. The answer itself is unchanged. - Changed
search.search-company-people
The search.search-company-people response is now documented field by field, as the same people page search.search-people returns. The answer itself is unchanged. - Changed
search.search-people
The search.search-people response is now documented field by field: the page fields, lookalikeSeeds and each person with hasKenEmail, kenEmailStatus, searchToken and behaviorTags. The answer itself is unchanged. - Added
account-domains.create
Published account-domains.create: add a domain to an account. - Added
account-domains.delete
Published account-domains.delete: remove a domain from an account. - Added
accounts.add-to-campaign
Published accounts.add-to-campaign: add an account's people to a campaign. - Added
accounts.bulk-create
Published accounts.bulk-create: create up to 100 accounts in one call, with a result per item. - Added
accounts.create
Published accounts.create: create an account from its domains. A domain another account owns answers 409 conflict with that account's id. - Added
accounts.delete
Published accounts.delete: delete an account. - Added
accounts.get
Published accounts.get: read one account with its domains, scores and deal totals. - Added
accounts.links
Published accounts.links: read an account's website, LinkedIn page and careers page. - Added
accounts.list
Published accounts.list: list your accounts, the companies you sell to, filtered by domain, stage, owner, tags and more, or search names and domains with q. - Added
accounts.merge
Published accounts.merge: merge a duplicate account into another. - Added
accounts.update
Published accounts.update: change an account's stage, owner, type and company fields. - Added
meeting-notes.create
Published meeting-notes.create: add call notes or a transcript to an account. - Added
meeting-notes.delete
Published meeting-notes.delete: delete a meeting note. - Added
meeting-notes.get
Published meeting-notes.get: read one meeting note in full. - Added
meeting-notes.list
Published meeting-notes.list: list an account's meeting notes. - Added
stakeholders.create
Published stakeholders.create: put a person on an account. - Added
stakeholders.delete
Published stakeholders.delete: take a person off an account. The person stays. - Added
stakeholders.list
Published stakeholders.list: list the people on an account with their role, priority and coverage. - Added
stakeholders.update
Published stakeholders.update: change a stakeholder's role, priority, coverage or note. - Added
campaigns.launch
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 launch the campaign again. The same key with a different request is 422 idempotency_key_reused. Only a 2xx response is kept, so a retry after a 4xx or 5xx runs the launch again. - Added
inboxes.create
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 connect the inbox again. The same key with a different request is 422 idempotency_key_reused. Only a 2xx response is kept, so a retry after a 4xx or 5xx runs the connect again. Kenso leaves password out of what it compares and keeps no trace of it, so a repeat that changes only the password gets the first response: send a new key when you change it. - Changed
threads.create
The reference now lists the Idempotency-Key header threads.create has always required (at most 200 characters, per workspace). A request without it answered 400 before and still does, so no request has to change. A reused key with a different request answers idempotency_key_reused with status 409 for now. Kenso will move it to 422, the status every other operation uses, and this changelog will announce the date: branch on the code, not the status. - Added
threads.create-message
The reference now lists the optional Idempotency-Key header this operation already read (at most 200 characters, per workspace). Kenso records the key with the reply, so a repeat with the same key does not send it twice. A reused key with a different request answers idempotency_key_reused with status 409 for now. Kenso will move it to 422, the status every other operation uses, and this changelog will announce the date: branch on the code, not the status. - Added
threads.forward
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 forward the message again. The same key with a different request is 422 idempotency_key_reused. Only a 2xx response is kept, so a retry after a 4xx or 5xx runs the forward again. - Added
webhook-endpoints.rotate-signing-secret
Added POST /v1/webhook-endpoints/{webhookEndpointId}/signing-secret/rotate: replaces an endpoint's signing secret and returns the new secret with previousSecretExpiresAt. For 24 hours every delivery carries a signature for each secret, so receivers can switch without dropping a delivery. - Added
status.get
New GET /v1/status returns the status of the Kenso API, sending and webhooks (operational, degraded, outage or unknown) and the worst of them. Sending is operational while a dispatch pass succeeded in the last 3 minutes, and webhooks while a dispatch run delivered or had nothing to deliver in the last 5 minutes. It takes no credential and no Ken-Version header, and is cacheable for 30 seconds. - Added
credit-ledger.list
The credit ledger can now be filtered by what each line was for: trigger, actorUserId, contactId, accountId, listId, workflowId, chatId (a Ken chat's lines, its Ken run included), runId (every line of one run) and q (text search over the description, title, web URL and the name of the line's object). action now takes several comma-separated actions. All are optional and combine with AND. - Changed
credits.get
Added optional field data.reservedItems[].nextRenewalAt to the credits.get response: when the next item of that action renews. - Added
credit-rate-card.get
Added optional header parameter X-Ken-Workspace-Id to credit-rate-card.get: send it to get the rate card of a workspace on the new plans. - Changed
credit-rate-card.get
Added optional field data.version (1, or 2 for a workspace on the new plans) and optional field data.items[].freePerDay (free uses a day) to the credit-rate-card.get response. - Changed
credits.get
Added optional field data.aiLimit (percentUsed, and state: ok, warning from 80% or reached) to the credits.get response: how much of the workspace's monthly AI limit is used, as a percent, never a dollar amount. It is present only while the workspace is on the new pricing with the AI limit enforced, and omitted otherwise. - Changed
campaigns.update
Added optional field emailVerifiers to the campaigns.update request: the verifiers that check the campaign's emails (kenso, leadmagic, findymail, zerobounce, neverbounce). zerobounce and neverbounce run on the workspace's own key; adding one without a working key is refused with provider_key_missing. Added optional fielddata.emailVerifiersto the campaigns.update response. - Changed
analytics.get-campaign-performance
Added optional field clicksTracked to the metrics of the analytics.get-campaign-performance response (window metrics, rows, and a segment row's steps and versions), beside opensTracked. false means the campaign sends as plain text, whose emails carry no click-tracking link, so its clickCount and clickRate are not real: clicks are partial (steps kept as HTML), not none. Omitted where opensTracked is omitted for the call, past billing grace, and on an imported campaign that would read false; where omitted, clicks are partly tracked or unknown: read clickRate as a floor. - Changed
saved-searches.create
The response of saved-searches.create is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - Changed
saved-searches.get
The response of saved-searches.get is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - Changed
saved-searches.share
The response of saved-searches.share is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - Changed
saved-searches.update
The response of saved-searches.update is now documented field by field: the saved search's id, name, type, filters, sharing and your access to it. - Changed
search.create-import
The response of search.create-import is now documented field by field: the new import's jobId and its status. - Changed
search.expand-industries
The response of search.expand-industries is now documented field by field: expandedIndustries maps each industry you sent to its related industries, and error says why when the expansion failed. - Changed
search.get-filters
The response of search.get-filters is now documented field by field: each filter's list of values (value, label, count and parent value), the location tree, and the country, state and company size counts. - Changed
search.get-import
The response of search.get-import is now documented field by field: the import's status, phase and counts, the people it skipped by reason, and its batch-by-batch progress. - Changed
search.get-metadata
The response of search.get-metadata is now documented field by field: with a category, one page of that category's values with pagination; without one, the whole filter catalog that search.get-filters returns. - Changed
Documentation fix: search.get-metadata always answered either a page of one category's values or the whole filter catalog; the reference now shows the two bodies as alternatives instead of one untyped body.
Optional fields added on 30 operations
- Changed
workspaces.get
Added optional fielddata.isSandboxto the workspaces.get response. - Changed
workspaces.list
Added optional fielddata[].isSandboxto the workspaces.list response. - Changed
workspaces.update
Added optional fielddata.isSandboxto the workspaces.update response. - Changed
contact-imports.buyer-preview
Added optional fielddata.companies[].people[].contact.searchTokento the contact-imports.buyer-preview response. - Changed
contact-imports.create
Added optional fieldcontacts[].searchTokento the contact-imports.create request. - Changed
campaigns.get-launch-readiness
Added optional fieldsdata.reasons[].refusal.feature,data.reasons[].refusal.requiredPlan,data.warnings[].refusal.featureanddata.warnings[].refusal.requiredPlanto the campaigns.get-launch-readiness response. - Changed
domains.get-health
Added optional fielddata.listedSinceto the domains.get-health response. - Changed
domains.list-health
Added optional fielddata[].listedSinceto the domains.list-health response. - Changed
campaigns.list-inboxes
Added optional fieldsdata[].oneToOneReadiness.signatureMessageanddata[].oneToOneReadiness.signatureWarningto the campaigns.list-inboxes response. - Changed
campaigns.replace-inboxes
Added optional fieldsdata[].oneToOneReadiness.signatureMessageanddata[].oneToOneReadiness.signatureWarningto the campaigns.replace-inboxes response. - Changed
inboxes.create
Added optional fieldsdata.oneToOneReadiness.signatureMessageanddata.oneToOneReadiness.signatureWarningto the inboxes.create response. - Changed
inboxes.disconnect
Added optional fieldsdata.oneToOneReadiness.signatureMessageanddata.oneToOneReadiness.signatureWarningto the inboxes.disconnect response. - Changed
campaigns.archive
Added optional fielddata.emailVerifiersto the campaigns.archive response. - Changed
campaigns.clear-launch-schedule
Added optional fielddata.emailVerifiersto the campaigns.clear-launch-schedule response. - Changed
campaigns.create
Added optional fielddata.emailVerifiersto the campaigns.create response. - Changed
campaigns.duplicate
Added optional fielddata.emailVerifiersto the campaigns.duplicate response. - Changed
campaigns.get
Added optional fielddata.emailVerifiersto the campaigns.get response. - Changed
campaigns.launch
Added optional fielddata.emailVerifiersto the campaigns.launch response. - Changed
campaigns.list
Added optional fielddata[].emailVerifiersto the campaigns.list response. - Changed
campaigns.pause
Added optional fielddata.emailVerifiersto the campaigns.pause response. - Changed
campaigns.restart
Added optional fielddata.emailVerifiersto the campaigns.restart response. - Changed
campaigns.resume
Added optional fielddata.emailVerifiersto the campaigns.resume response. - Changed
campaigns.set-launch-schedule
Added optional fielddata.emailVerifiersto the campaigns.set-launch-schedule response. - Changed
campaigns.unarchive
Added optional fielddata.emailVerifiersto the campaigns.unarchive response. - Changed
inboxes.get
Added optional fieldsdata.oneToOneReadiness.signatureMessageanddata.oneToOneReadiness.signatureWarningto the inboxes.get response. - Changed
inboxes.get-one-to-one-readiness
Added optional fieldsdata.signatureMessageanddata.signatureWarningto the inboxes.get-one-to-one-readiness response. - Changed
inboxes.list
Added optional fieldsdata[].oneToOneReadiness.signatureMessageanddata[].oneToOneReadiness.signatureWarningto the inboxes.list response. - Changed
inboxes.rename
Added optional fieldsdata.inbox.oneToOneReadiness.signatureMessageanddata.inbox.oneToOneReadiness.signatureWarningto the inboxes.rename response. - Changed
inboxes.update
Added optional fieldsdata.oneToOneReadiness.signatureMessageanddata.oneToOneReadiness.signatureWarningto the inboxes.update response. - Changed
inboxes.verify
Added optional fieldsdata.oneToOneReadiness.signatureMessageanddata.oneToOneReadiness.signatureWarningto the inboxes.verify response.