Skip to Content

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.

84 changesRSS feed
Markdown

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 field data.emailVerifiers to 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 field data.isSandbox to the workspaces.get response.
  • Changed workspaces.list
    Added optional field data[].isSandbox to the workspaces.list response.
  • Changed workspaces.update
    Added optional field data.isSandbox to the workspaces.update response.
  • Changed contact-imports.buyer-preview
    Added optional field data.companies[].people[].contact.searchToken to the contact-imports.buyer-preview response.
  • Changed contact-imports.create
    Added optional field contacts[].searchToken to the contact-imports.create request.
  • Changed campaigns.get-launch-readiness
    Added optional fields data.reasons[].refusal.feature, data.reasons[].refusal.requiredPlan, data.warnings[].refusal.feature and data.warnings[].refusal.requiredPlan to the campaigns.get-launch-readiness response.
  • Changed domains.get-health
    Added optional field data.listedSince to the domains.get-health response.
  • Changed domains.list-health
    Added optional field data[].listedSince to the domains.list-health response.
  • Changed campaigns.list-inboxes
    Added optional fields data[].oneToOneReadiness.signatureMessage and data[].oneToOneReadiness.signatureWarning to the campaigns.list-inboxes response.
  • Changed campaigns.replace-inboxes
    Added optional fields data[].oneToOneReadiness.signatureMessage and data[].oneToOneReadiness.signatureWarning to the campaigns.replace-inboxes response.
  • Changed inboxes.create
    Added optional fields data.oneToOneReadiness.signatureMessage and data.oneToOneReadiness.signatureWarning to the inboxes.create response.
  • Changed inboxes.disconnect
    Added optional fields data.oneToOneReadiness.signatureMessage and data.oneToOneReadiness.signatureWarning to the inboxes.disconnect response.
  • Changed campaigns.archive
    Added optional field data.emailVerifiers to the campaigns.archive response.
  • Changed campaigns.clear-launch-schedule
    Added optional field data.emailVerifiers to the campaigns.clear-launch-schedule response.
  • Changed campaigns.create
    Added optional field data.emailVerifiers to the campaigns.create response.
  • Changed campaigns.duplicate
    Added optional field data.emailVerifiers to the campaigns.duplicate response.
  • Changed campaigns.get
    Added optional field data.emailVerifiers to the campaigns.get response.
  • Changed campaigns.launch
    Added optional field data.emailVerifiers to the campaigns.launch response.
  • Changed campaigns.list
    Added optional field data[].emailVerifiers to the campaigns.list response.
  • Changed campaigns.pause
    Added optional field data.emailVerifiers to the campaigns.pause response.
  • Changed campaigns.restart
    Added optional field data.emailVerifiers to the campaigns.restart response.
  • Changed campaigns.resume
    Added optional field data.emailVerifiers to the campaigns.resume response.
  • Changed campaigns.set-launch-schedule
    Added optional field data.emailVerifiers to the campaigns.set-launch-schedule response.
  • Changed campaigns.unarchive
    Added optional field data.emailVerifiers to the campaigns.unarchive response.
  • Changed inboxes.get
    Added optional fields data.oneToOneReadiness.signatureMessage and data.oneToOneReadiness.signatureWarning to the inboxes.get response.
  • Changed inboxes.get-one-to-one-readiness
    Added optional fields data.signatureMessage and data.signatureWarning to the inboxes.get-one-to-one-readiness response.
  • Changed inboxes.list
    Added optional fields data[].oneToOneReadiness.signatureMessage and data[].oneToOneReadiness.signatureWarning to the inboxes.list response.
  • Changed inboxes.rename
    Added optional fields data.inbox.oneToOneReadiness.signatureMessage and data.inbox.oneToOneReadiness.signatureWarning to the inboxes.rename response.
  • Changed inboxes.update
    Added optional fields data.oneToOneReadiness.signatureMessage and data.oneToOneReadiness.signatureWarning to the inboxes.update response.
  • Changed inboxes.verify
    Added optional fields data.oneToOneReadiness.signatureMessage and data.oneToOneReadiness.signatureWarning to the inboxes.verify response.

More