> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [https://api.ken.so/v1/docs/openapi.json](https://api.ken.so/v1/docs/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Kenso API changes on 2026-11-13

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

Every change on this day, by version. The [changelog](/docs/changelog) lists the newest days and links the older ones. The changelog in Markdown: [/docs/changelog.md](/docs/changelog.md).

## Version 2026-11-02

### 2026-11-13 (54 changes)

- **Changed**: The inbox schema of the campaigns.list-inboxes response gained the optional field oneToOneReadiness, which this response leaves out. Read inboxes.get or inboxes.list for it. - [`campaigns.list-inboxes`](/docs/api/campaigns/list-inboxes.md)
- **Changed**: The inbox schema of the campaigns.replace-inboxes response gained the optional field oneToOneReadiness, which this response leaves out. Read inboxes.get or inboxes.list for it. - [`campaigns.replace-inboxes`](/docs/api/campaigns/replace-inboxes.md)
- **Changed**: The inbox schema of the inboxes.create response gained the optional field oneToOneReadiness, which this response leaves out. Read inboxes.get or inboxes.list for it. - [`inboxes.create`](/docs/api/inboxes/create.md)
- **Changed**: Added optional field data.oneToOneReadiness to the inboxes.disconnect response: whether an approved one-to-one email that names the inbox goes out now, with inboxId, email, senderKind, canSend, and reason and message when it cannot. The same answer as inboxes.get-one-to-one-readiness. - [`inboxes.disconnect`](/docs/api/inboxes/disconnect.md)
- **Changed**: Added optional field data.oneToOneReadiness to the inboxes.get response: whether an approved one-to-one email that names the inbox goes out now, with inboxId, email, senderKind, canSend, and reason and message when it cannot. The same answer as inboxes.get-one-to-one-readiness. - [`inboxes.get`](/docs/api/inboxes/get.md)
- **Changed**: Added optional field data[].oneToOneReadiness to the inboxes.list response: whether an approved one-to-one email that names the inbox goes out now, with inboxId, email, senderKind, canSend, and reason and message when it cannot. The same answer as inboxes.get-one-to-one-readiness. - [`inboxes.list`](/docs/api/inboxes/list.md)
- **Changed**: Added optional field data.inbox.oneToOneReadiness to the inboxes.rename response: whether an approved one-to-one email that names the inbox goes out now, with inboxId, email, senderKind, canSend, and reason and message when it cannot. The same answer as inboxes.get-one-to-one-readiness. - [`inboxes.rename`](/docs/api/inboxes/rename.md)
- **Changed**: Added optional field data.oneToOneReadiness to the inboxes.update response: whether an approved one-to-one email that names the inbox goes out now, with inboxId, email, senderKind, canSend, and reason and message when it cannot. The same answer as inboxes.get-one-to-one-readiness. - [`inboxes.update`](/docs/api/inboxes/update.md)
- **Changed**: Added optional field data.oneToOneReadiness to the inboxes.verify response: whether an approved one-to-one email that names the inbox goes out now, with inboxId, email, senderKind, canSend, and reason and message when it cannot. The same answer as inboxes.get-one-to-one-readiness. - [`inboxes.verify`](/docs/api/inboxes/verify.md)
- **Changed**: Changed: open tracking is unavailable on inboxes; `PATCH /v1/inboxes/{inboxId}` refuses `trackOpens` `true` with `open_tracking_unavailable` and saves nothing. `false` is accepted as before. - [`inboxes.update`](/docs/api/inboxes/update.md)
- **Added**: Added segments.set-provider-track: give one provider track its own copy of a segment's email sequence, or share the segment's again. - [`segments.set-provider-track`](/docs/api/segments/set-provider-track.md)
- **Changed**: Added optional field data.id to the bug-reports.create response: the report's opaque id, which adds a note to it for 24 hours. - [`bug-reports.create`](/docs/api/bug-reports/create.md)
- **Added**: Added bug-reports.notes-create (POST /v1/bug-reports/{bugReportId}/notes): the member who filed a bug report adds a note to it within 24 hours. - [`bug-reports.notes-create`](/docs/api/bug-reports/notes-create.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.archive response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.archive`](/docs/api/campaigns/archive.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.clear-launch-schedule response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.clear-launch-schedule`](/docs/api/campaigns/clear-launch-schedule.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.create response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.create`](/docs/api/campaigns/create.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.duplicate response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.duplicate`](/docs/api/campaigns/duplicate.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.get response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.get`](/docs/api/campaigns/get.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.launch response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.launch`](/docs/api/campaigns/launch.md)
- **Changed**: Added optional field data[].tagIds to the campaigns.list response: the ids of the tags on the campaign, ascending, empty when it has none. - [`campaigns.list`](/docs/api/campaigns/list.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.pause response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.pause`](/docs/api/campaigns/pause.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.restart response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.restart`](/docs/api/campaigns/restart.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.resume response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.resume`](/docs/api/campaigns/resume.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.set-launch-schedule response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.set-launch-schedule`](/docs/api/campaigns/set-launch-schedule.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.unarchive response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.unarchive`](/docs/api/campaigns/unarchive.md)
- **Changed**: Added optional field `data.tagIds` to the campaigns.update response. It is filled only on campaigns.list items and omitted on this response. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Changed**: Added optional field data.steps[].campaignId to the step schema of the email-sequences.get response. This response never includes it: it names a step's campaign only where a step is returned on its own. - [`email-sequences.get`](/docs/api/email-sequences/get.md)
- **Changed**: Added optional field data.steps[].campaignId to the step schema of the email-sequences.replace response. This response never includes it: it names a step's campaign only where a step is returned on its own. - [`email-sequences.replace`](/docs/api/email-sequences/replace.md)
- **Changed**: Added optional field data.steps[].campaignId to the step schema of the segment-email-sequences.get response. This response never includes it: it names a step's campaign only where a step is returned on its own. - [`segment-email-sequences.get`](/docs/api/segment-email-sequences/get.md)
- **Changed**: Added optional field data.steps[].campaignId to the step schema of the segment-email-sequences.replace response. This response never includes it: it names a step's campaign only where a step is returned on its own. - [`segment-email-sequences.replace`](/docs/api/segment-email-sequences/replace.md)
- **Changed**: Added optional field data.sequence.steps[].campaignId to the step schema of the segment-email-sequences.save-version response. This response never includes it: it names a step's campaign only where a step is returned on its own. - [`segment-email-sequences.save-version`](/docs/api/segment-email-sequences/save-version.md)
- **Added**: New: `GET /v1/deliverability-rules` lists the client-visible deliverability rules in force for the workspace. - [`deliverability-rules.list`](/docs/api/deliverability-rules/list.md)
- **Changed**: Changed: `trackOpens` on campaigns is always false; `PATCH /v1/campaigns/{campaignId}` refuses `true` with `open_tracking_unavailable`. - [`campaigns.update`](/docs/api/campaigns/update.md)
- **Added**: Added social-lookups.create. - [`social-lookups.create`](/docs/api/social-lookups/create.md)
- **Added**: Added social-lookups.get. - [`social-lookups.get`](/docs/api/social-lookups/get.md)
- **Added**: Added social-records.list. - [`social-records.list`](/docs/api/social-records/list.md)
- **Added**: Added social-resolutions.create. - [`social-resolutions.create`](/docs/api/social-resolutions/create.md)
- **Added**: Added social-searches.create. - [`social-searches.create`](/docs/api/social-searches/create.md)
- **Added**: Added social-searches.get. - [`social-searches.get`](/docs/api/social-searches/get.md)
- **Added**: Added domains.list-health: GET /v1/domains/health?domainIds= returns the health of up to 200 domains in one call, each item the domains.get-health object. - [`domains.list-health`](/docs/api/domains/list-health.md)
- **Added**: Added optional query parameter domainIds to placement-tests.list: the newest limit tests of each of up to 50 domains in one call. - [`placement-tests.list`](/docs/api/placement-tests/list.md)
- **Changed**: Added optional field trackLinks to the placement-tests.create request: on the Kenso seed network, false sends the body's links as written instead of as tracked links (default true). The 200 and 201 responses add data.trackLinks on Kenso tests. - [`placement-tests.create`](/docs/api/placement-tests/create.md)
- **Changed**: Added optional field data.trackLinks to the placement-tests.get response: on Kenso tests, false when the test sent its links as written. - [`placement-tests.get`](/docs/api/placement-tests/get.md)
- **Changed**: Added optional field data[].trackLinks to the placement-tests.list response: on Kenso tests, false when the test sent its links as written. - [`placement-tests.list`](/docs/api/placement-tests/list.md)
- **Changed**: Line orders now open per workspace. While they are not open for the workspace, an order is refused 503 service_unavailable with error.details[0].code orders_closed (field imessage_line_orders) and the message "iMessage line orders aren't open yet.", before the line limit, the credit check, any charge, the line or the buy. Retrying with the Idempotency-Key of an order that went through still returns that line (201). Needs the imessage feature, which is off for every workspace for now. - [`imessage-lines.order`](/docs/api/imessage-lines/order.md)
- **Changed**: Added optional followUp to the request (Kenso seed network): body, format (plain or html), delayMinutes (5 to 4320) and an optional subject. Each seed then also gets a follow-up from the same inbox in the first email's thread, sent only after the first email was sent and the delay passed. The 200 and 201 responses carry the same followUp and seeds[].followUp fields as placement-tests.get. - [`placement-tests.create`](/docs/api/placement-tests/create.md)
- **Changed**: Added optional followUp to the response for a Kenso test started with one: format, delayMinutes, subject, body, counts and providers. Each seeds[] row also carries followUp, where that seed's follow-up landed. The other result fields keep describing the first email. - [`placement-tests.get`](/docs/api/placement-tests/get.md)
- **Changed**: Added optional followUp (format, delayMinutes, subject) to each test in the list, for a Kenso test started with a follow-up. - [`placement-tests.list`](/docs/api/placement-tests/list.md)
- **Added**: Added segments.get-provider-tracks: a segment's provider tracks (google, microsoft, other) with the contacts on each. - [`segments.get-provider-tracks`](/docs/api/segments/get-provider-tracks.md)

Optional fields added on 5 operations:

- **Changed**: Added optional fields `data.rows[].domainHealth`, `data.rows[].domainHealth.action`, `data.rows[].domainHealth.evaluatedAt`, `data.rows[].domainHealth.message`, `data.rows[].domainHealth.reason`, `data.rows[].domainHealth.rung`, `data.rows[].domainHealth.since` and `data.rows[].domainHealth.until` to the analytics.get-deliverability response. - [`analytics.get-deliverability`](/docs/api/analytics/get-deliverability.md)
- **Changed**: Added optional fields `data.health`, `data.health.action`, `data.health.evaluatedAt`, `data.health.message`, `data.health.reason`, `data.health.rung`, `data.health.since` and `data.health.until` to the domains.get response. - [`domains.get`](/docs/api/domains/get.md)
- **Changed**: Added optional fields `data[].health`, `data[].health.action`, `data[].health.evaluatedAt`, `data[].health.message`, `data[].health.reason`, `data[].health.rung`, `data[].health.since` and `data[].health.until` to the domains.list response. - [`domains.list`](/docs/api/domains/list.md)
- **Changed**: Added optional fields `data.health`, `data.health.action`, `data.health.evaluatedAt`, `data.health.message`, `data.health.reason`, `data.health.rung`, `data.health.since` and `data.health.until` to the domains.update response. - [`domains.update`](/docs/api/domains/update.md)
- **Changed**: Added optional field `data.hostnames[].dnsWriterKind` to the outbound-site.domain-get response. - [`outbound-site.domain-get`](/docs/api/outbound-site/domain-get.md)

- Newer day: [2026-11-14](/docs/changelog/2026-11-14.md)
- Older day: [2026-11-12](/docs/changelog/2026-11-12.md)
- Every change: [/docs/changelog.md](/docs/changelog.md)
