Skip to Content

Kenso API changes on 2026-11-16

Every change on this day, by version. The changelog lists the newest days and links the older ones.

163 changesRSS feed
Markdown

Version 2026-11-02

2026-11-16 163 changes

  • Added sandboxes.list
    Added optional query parameters limit and cursor to sandboxes.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added agent-sandbox-connections.list
    Added optional query parameters limit and cursor to agent-sandbox-connections.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added ai-feedback.list
    Added optional query parameters limit and cursor to ai-feedback.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added ai-lines.list
    Added optional query parameters limit and cursor to ai-lines.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added blocklist-rules.list
    Added optional query parameters limit and cursor to blocklist-rules.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added campaign-images.list
    Added optional query parameters limit and cursor to campaign-images.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added campaign-localizations.list
    Added optional query parameters limit and cursor to campaign-localizations.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added crm-connections.list
    Added optional query parameters limit and cursor to crm-connections.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added crm-fields.list
    Added optional query parameters limit and cursor to crm-fields.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added crm-lists.list
    Added optional query parameters limit and cursor to crm-lists.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added crm-pipelines.list
    Added optional query parameters limit and cursor to crm-pipelines.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added permission-templates.list
    Added optional query parameters limit and cursor to permission-templates.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added trigger-schemas.list
    Added optional query parameters limit and cursor to trigger-schemas.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added voices.list
    Added optional query parameters limit and cursor to voices.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Added webhook-event-types.list
    Added optional query parameters limit and cursor to webhook-event-types.list. Without them the response still holds every item, as before; with either, it returns that page with pagination.nextCursor and pagination.totalCount.
  • Changed
    Documentation fix: the reference showed a generic problem body (type, title, status, detail, instance) for some errors of bookings.bulk-cancel, bookings.bulk-reassign, bookings.no-show, email-copy-grades.grade, external-bookings.get, external-bookings.list and translations.create, which always answered with the standard Kenso error body that the reference now shows, so no response changed.
  • Changed
    Documentation fix: request fields the API already required are now listed as required, and fields that are never null (response fields Kenso always sends, and required request fields) are no longer marked nullable, so generated samples and SDK types match what the API accepts and returns.
  • Changed accounts.update
    Added optional field customFields to the accounts.update request: values of the account's custom fields by key, merged per key, with null clearing a key. Each value is checked against its field's type. Refused with validation_failed (not_enabled) until custom fields are on for the workspace.
  • Changed account-domains.create
    Added optional fields data.customFields and data.customFieldMeta to the account-domains.create response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed account-domains.delete
    Added optional fields data.customFields and data.customFieldMeta to the account-domains.delete response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed accounts.bulk-create
    Added optional fields data.results[].account.customFields and data.results[].account.customFieldMeta to the accounts.bulk-create response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed accounts.create
    Added optional fields data.customFields and data.customFieldMeta to the accounts.create response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed accounts.get
    Added optional fields data.customFields and data.customFieldMeta to the accounts.get response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed accounts.list
    Added optional fields data[].customFields and data[].customFieldMeta to the accounts.list response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed accounts.merge
    Added optional fields data.customFields and data.customFieldMeta to the accounts.merge response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed accounts.update
    Added optional fields data.customFields and data.customFieldMeta to the accounts.update response: the account's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Changed people.intake
    Added optional fields data.person.customFields and data.person.customFieldMeta to the people.intake response: the person's custom field values by key, and for each key that has a record of it, who or what set the value (source, at and memberId).
  • Added campaigns.list
    Added optional query parameters sort (createdAt or -createdAt), createdAfter and createdBefore to campaigns.list.
  • Changed me.get
    Field data.emailVerified in the me.get response is now omitted when Kenso has no record either way (a password sign-in whose verification was never recorded), where it read false before. true and false keep their meaning. The field was never required.
  • Added contacts.list
    GET /v1/contacts takes personId: the person's contact in each campaign they are in.
  • Changed me.get
    Added field data.emailVerified to the me.get response: whether Kenso treats the caller's email as verified (confirmed from the verification email, or a Google, LinkedIn or Microsoft sign-in).
  • Added contacts.list
    contacts.list takes sort: createdAt lists contacts oldest first and -createdAt newest first. Omitted keeps the id order.
  • Added lists.list
    lists.list takes createdAfter and createdBefore to keep the lists created in a range, and sort (createdAt or -createdAt) to order them by creation time.
  • Added webhook-deliveries.list
    webhook-deliveries.list takes createdAfter and createdBefore to keep the attempts made in a range (their occurredAt), and sort=-createdAt, the newest-first order it already lists in.
  • Changed credits.get
    The credits response can carry an optional smtpSending block for SMTP inboxes billed per campaign email: millicreditsPerEmail (250, that is 0.25 credits or $5 per 1,000 emails), inboxesPerDomain, startDailyLimit, dailyStep, maxDailyLimit, and paused (true while the credits the workspace bought cannot pay for one email). The credit action list gains smtp_email for those emails on ledger lines. Both stay out of every response until per-email SMTP billing is turned on.
  • Changed webhook-endpoints.create
    A webhook endpoint takes an optional schemaVersion: 2026-11, the default, or 2026-12, which is rolling out. A 2026-12 endpoint receives payloads with workspaceId in place of clientId, no null values, snake_case enum values and dotted event type names. The response returns the endpoint's schemaVersion.
  • Changed webhook-endpoints.get
    Each webhook endpoint returns its schemaVersion, 2026-11 or 2026-12. A 2026-12 endpoint lists its events by dotted name.
  • Changed webhook-endpoints.list
    Each webhook endpoint in the list returns its schemaVersion, 2026-11 or 2026-12. A 2026-12 endpoint lists its events by dotted name.
  • Changed webhook-endpoints.update
    schemaVersion switches a webhook endpoint between the 2026-11 and 2026-12 payload schemas, with the same rules as on create. The response returns the endpoint's schemaVersion.
  • Changed webhook-event-types.list
    Each event type now lists its aliases: the ten types named before the dotted convention each take a dotted alias, such as email.sent for email_sent, wherever you name an event type. An endpoint subscribed by both names gets each event once.
  • Changed
    refusal.planType now uses snake_case plan ids, the same spelling as refusal.requiredPlan: free, platform, performance, basic, growth, pro. The retired plans read legacy_core, legacy_premium, legacy_dfy, legacy_starter and legacy_growth. It returned capitalized names (Free, Platform, Core, Premium, Dfy, Starter). If you compare planType to Free or Core, compare to free or legacy_core.
  • Changed job-post-searches.companies
    The job-post-searches.companies response is now documented field by field: the snake_case page of hiring companies with their jobs, pagination.next_cursor, and hiringSet. The answer itself is unchanged.
  • Changed saved-searches.run
    The saved-searches.run response is now documented field by field, as one of two answers that searchType tells apart: People, with the first page of a people search, or Account, with the first page of a company search. The answer itself is unchanged: success and data are still there, inside each of the two answers.
  • Changed search.get-company
    The search.get-company response is now documented field by field: the whole company record. The answer itself is unchanged.
  • Changed search.get-company-facets
    The search.get-company-facets response is now documented field by field: each facet's values with their counts, and the facets companies never count, which are always null. The answer itself is unchanged.
  • Breaking agent-team.create-action
    Removed agent-team.create-action.
    Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
  • Breaking agent-team.create-proposal
    Removed agent-team.create-proposal.
    Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
  • Breaking agent-team.get-runway
    Removed agent-team.get-runway.
    Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
  • Breaking agent-team.list-changes
    Removed agent-team.list-changes.
    Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
  • Breaking agent-team.list-proposals
    Removed agent-team.list-proposals.
    Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
  • Breaking agent-team.undo-action
    Removed agent-team.undo-action.
    Migration: The in-app AI team was stopped on 2026-10-29 and its code is deleted. Its flags (agent_teams, agent_templates) were off for every workspace, so these operations already answered 404. They have no replacement. Campaign pause, resume and settings keep their own operations.
  • Changed search.lookup-company
    The search.lookup-company response is now documented field by field: the whole company record. The answer itself is unchanged.
  • Changed search.search-companies
    The search.search-companies response is now documented field by field: the page fields, lookalikeSeeds and each company with its firmographics, funding, headcount signals, leadershipChanges, hiringSurges and webTechnologies. The answer itself is unchanged.
  • Changed funding-rounds.export
    The JSON response of funding-rounds.export is now documented field by field: the exported fundingRounds and their total. The JSON itself is unchanged.
  • Changed funding-rounds.get
    The response of funding-rounds.get is now documented field by field: the round, its company, the people named on it and its history of other reports. The JSON itself is unchanged.
  • Changed funding-rounds.resolve-filters
    The response of funding-rounds.resolve-filters is now documented field by field: each matching value with its label and count. The JSON itself is unchanged.
  • Changed funding-rounds.search
    The response of funding-rounds.search is now documented field by field: the rounds (or companies with groupBy: "company"), total, totalIsCapped, pagination.nextCursor and the optional facets. The JSON itself is unchanged.
  • Changed job-postings.export
    The JSON response of job-postings.export is now documented field by field: the exported signals and their total. The JSON itself is unchanged.
  • Changed job-postings.get
    The response of job-postings.get is now documented field by field: the posting in job, its revisions, and the source's own raw and raw_detail records, which stay free-form. The JSON itself is unchanged.
  • Changed job-postings.resolve-filters
    The response of job-postings.resolve-filters is now documented field by field: the matching companies, titles and locations with their counts. The JSON itself is unchanged.
  • Changed job-postings.search
    The response of job-postings.search is now documented field by field: the postings in signals (or companies with groupBy: "company"), total, totalMode, notes, pagination.next_cursor and the optional facets. The JSON itself is unchanged.
  • Changed scraping.map
    The response of scraping.map is now documented field by field: success and the links found, each with its url, title and description. The JSON itself is unchanged.
  • Changed scraping.scrape
    The response of scraping.scrape is now documented field by field: success and the page in data, with its formats (markdown, html, rawHtml, links, summary, screenshot, and json, which stays free-form) and its metadata. The page objects stay open to other fields, such as the page's meta tags. The JSON itself is unchanged.
  • Changed scraping.search
    The response of scraping.search is now documented field by field: success, creditsUsed and the web results in data, each with its url, title and description. Results stay open to the scraped content scrapeOptions adds. The JSON itself is unchanged.
  • Changed triggers.preview
    The response of triggers.preview is now documented field by field: the sample companies for each signal type, total, the filter steps, the estimatedCredits and pagination. The JSON itself is unchanged.
  • Changed
    The reference now lists attachments.get-content's file download as application/octet-stream: it always answered with the file's own content type, never JSON.
  • Added sandboxes.create-test-key
    Added sandboxes.create-test-key (POST /v1/sandboxes/{sandboxId}/test-keys): returns another test key (kenso_test_) for your developer sandbox. A sandbox holds 5 active test keys at most. Available where developer sandboxes are turned on.
  • Added sandboxes.delete
    Added sandboxes.delete (DELETE /v1/sandboxes/{sandboxId}): revokes your developer sandbox's test keys and deletes it. Available where developer sandboxes are turned on.
  • Added sandboxes.reset
    Added sandboxes.reset (POST /v1/sandboxes/{sandboxId}/reset): deletes everything in your developer sandbox and seeds it again; its test keys and webhook endpoints stay. Creating and resetting share a limit of 10 a day per workspace. Available where developer sandboxes are turned on.
Optional fields added on 94 operations
  • Changed access-requests.list
    Added optional field pagination.totalCount to the access-requests.list response.
  • Changed accounts.list
    Added optional field pagination.totalCount to the accounts.list response.
  • Changed agent-sandbox-connections.list
    Added optional field pagination.totalCount to the agent-sandbox-connections.list response.
  • Changed agent-sandbox-runs.list
    Added optional field pagination.totalCount to the agent-sandbox-runs.list response.
  • Changed ai-feedback.list
    Added optional field pagination.totalCount to the ai-feedback.list response.
  • Changed ai-line-holds.list
    Added optional field pagination.totalCount to the ai-line-holds.list response.
  • Changed ai-lines.list
    Added optional field pagination.totalCount to the ai-lines.list response.
  • Changed auto-pauses.list
    Added optional field pagination.totalCount to the auto-pauses.list response.
  • Changed blocklist-entries.list
    Added optional field pagination.totalCount to the blocklist-entries.list response.
  • Changed blocklist-rules.list
    Added optional field pagination.totalCount to the blocklist-rules.list response.
  • Changed booking-links.list
    Added optional field pagination.totalCount to the booking-links.list response.
  • Changed bookings.list
    Added optional field pagination.totalCount to the bookings.list response.
  • Changed calling.numbers-available
    Added optional field pagination.totalCount to the calling.numbers-available response.
  • Changed calling.numbers-list
    Added optional field pagination.totalCount to the calling.numbers-list response.
  • Changed calling.voicemails-list
    Added optional field pagination.totalCount to the calling.voicemails-list response.
  • Changed campaign-images.list
    Added optional field pagination.totalCount to the campaign-images.list response.
  • Changed campaign-localizations.generate
    Added optional field pagination.totalCount to the campaign-localizations.generate response.
  • Changed campaign-localizations.list
    Added optional field pagination.totalCount to the campaign-localizations.list response.
  • Changed campaigns.list
    Added optional field pagination.totalCount to the campaigns.list response.
  • Changed campaigns.list-ai-workflows
    Added optional field pagination.totalCount to the campaigns.list-ai-workflows response.
  • Changed campaigns.list-inboxes
    Added optional field pagination.totalCount to the campaigns.list-inboxes response.
  • Changed campaigns.list-linkedin-accounts
    Added optional field pagination.totalCount to the campaigns.list-linkedin-accounts response.
  • Changed campaigns.replace-ai-workflows
    Added optional field pagination.totalCount to the campaigns.replace-ai-workflows response.
  • Changed campaigns.replace-inboxes
    Added optional field pagination.totalCount to the campaigns.replace-inboxes response.
  • Changed campaigns.replace-linkedin-accounts
    Added optional field pagination.totalCount to the campaigns.replace-linkedin-accounts response.
  • Changed client-approvals.list-events
    Added optional field pagination.totalCount to the client-approvals.list-events response.
  • Changed client-approvals.list-items
    Added optional field pagination.totalCount to the client-approvals.list-items response.
  • Changed companies.list
    Added optional field pagination.totalCount to the companies.list response.
  • Changed contact-fields.list
    Added optional field pagination.totalCount to the contact-fields.list response.
  • Changed contacts.events
    Added optional field pagination.totalCount to the contacts.events response.
  • Changed contacts.list
    Added optional field pagination.totalCount to the contacts.list response.
  • Changed contacts.list-website-pages
    Added optional field pagination.totalCount to the contacts.list-website-pages response.
  • Changed contacts.search
    Added optional field pagination.totalCount to the contacts.search response.
  • Changed credit-ledger.list
    Added optional field pagination.totalCount to the credit-ledger.list response.
  • Changed credit-savings-rows.list
    Added optional field pagination.totalCount to the credit-savings-rows.list response.
  • Changed crm-connections.list
    Added optional field pagination.totalCount to the crm-connections.list response.
  • Changed crm-fields.list
    Added optional field pagination.totalCount to the crm-fields.list response.
  • Changed crm-lists.list
    Added optional field pagination.totalCount to the crm-lists.list response.
  • Changed crm-pipelines.list
    Added optional field pagination.totalCount to the crm-pipelines.list response.
  • Changed crm-records.lookup
    Added optional field pagination.totalCount to the crm-records.lookup response.
  • Changed crm-sync-issues.list
    Added optional field pagination.totalCount to the crm-sync-issues.list response.
  • Changed custom-variables.list
    Added optional field pagination.totalCount to the custom-variables.list response.
  • Changed domains.list
    Added optional field pagination.totalCount to the domains.list response.
  • Changed domains.list-health
    Added optional field pagination.totalCount to the domains.list-health response.
  • Changed event-subscriptions.list
    Added optional field pagination.totalCount to the event-subscriptions.list response.
  • Changed events.list
    Added optional field pagination.totalCount to the events.list response.
  • Changed external-bookings.list
    Added optional field pagination.totalCount to the external-bookings.list response.
  • Changed image-variables.list
    Added optional field pagination.totalCount to the image-variables.list response.
  • Changed inbound-webhooks.deliveries
    Added optional field pagination.totalCount to the inbound-webhooks.deliveries response.
  • Changed inbound-webhooks.list
    Added optional field pagination.totalCount to the inbound-webhooks.list response.
  • Changed inbound-webhooks.list-people-sources
    Added optional field pagination.totalCount to the inbound-webhooks.list-people-sources response.
  • Changed inboxes.list
    Added optional field pagination.totalCount to the inboxes.list response.
  • Changed infra.findings
    Added optional field pagination.totalCount to the infra.findings response.
  • Changed jobs.list
    Added optional field pagination.totalCount to the jobs.list response.
  • Changed linkedin-accounts.list
    Added optional field pagination.totalCount to the linkedin-accounts.list response.
  • Changed linkedin-sequences.list-versions
    Added optional field pagination.totalCount to the linkedin-sequences.list-versions response.
  • Changed lists.list
    Added optional field pagination.totalCount to the lists.list response.
  • Changed markets.list
    Added optional field pagination.totalCount to the markets.list response.
  • Changed meeting-notes.list
    Added optional field pagination.totalCount to the meeting-notes.list response.
  • Changed meeting-types.list
    Added optional field pagination.totalCount to the meeting-types.list response.
  • Changed message-templates.list
    Added optional field pagination.totalCount to the message-templates.list response.
  • Changed outbound-site.versions-list
    Added optional field pagination.totalCount to the outbound-site.versions-list response.
  • Changed permission-templates.list
    Added optional field pagination.totalCount to the permission-templates.list response.
  • Changed placement-tests.list
    Added optional field pagination.totalCount to the placement-tests.list response.
  • Changed prompt-versions.list
    Added optional field pagination.totalCount to the prompt-versions.list response.
  • Changed prompts.list
    Added optional field pagination.totalCount to the prompts.list response.
  • Changed reply-templates.list
    Added optional field pagination.totalCount to the reply-templates.list response.
  • Changed sandboxes.list
    Added optional field pagination.totalCount to the sandboxes.list response.
  • Changed saved-list-members.list
    Added optional field pagination.totalCount to the saved-list-members.list response.
  • Changed saved-lists.list
    Added optional field pagination.totalCount to the saved-lists.list response.
  • Changed saved-lists.list-grants
    Added optional field pagination.totalCount to the saved-lists.list-grants response.
  • Changed saved-lists.list-members
    Added optional field pagination.totalCount to the saved-lists.list-members response.
  • Changed segment-email-sequences.list-versions
    Added optional field pagination.totalCount to the segment-email-sequences.list-versions response.
  • Changed segment-linkedin-sequences.list-versions
    Added optional field pagination.totalCount to the segment-linkedin-sequences.list-versions response.
  • Changed segments.list
    Added optional field pagination.totalCount to the segments.list response.
  • Changed segments.list-versions
    Added optional field pagination.totalCount to the segments.list-versions response.
  • Changed shares.list
    Added optional field pagination.totalCount to the shares.list response.
  • Changed social-records.list
    Added optional field pagination.totalCount to the social-records.list response.
  • Changed stakeholders.list
    Added optional field pagination.totalCount to the stakeholders.list response.
  • Changed tags.list
    Added optional field pagination.totalCount to the tags.list response.
  • Changed threads.list
    Added optional field pagination.totalCount to the threads.list response.
  • Changed threads.list-messages
    Added optional field pagination.totalCount to the threads.list-messages response.
  • Changed tracking-links.list
    Added optional field pagination.totalCount to the tracking-links.list response.
  • Changed trigger-firings.list
    Added optional field pagination.totalCount to the trigger-firings.list response.
  • Changed trigger-schemas.list
    Added optional field pagination.totalCount to the trigger-schemas.list response.
  • Changed triggers.list
    Added optional field pagination.totalCount to the triggers.list response.
  • Changed triggers.list-linkedin-engagements
    Added optional field pagination.totalCount to the triggers.list-linkedin-engagements response.
  • Changed voices.list
    Added optional field pagination.totalCount to the voices.list response.
  • Changed voices.list-importable
    Added optional field pagination.totalCount to the voices.list-importable response.
  • Changed webhook-deliveries.list
    Added optional field pagination.totalCount to the webhook-deliveries.list response.
  • Changed webhook-endpoints.list
    Added optional field pagination.totalCount to the webhook-endpoints.list response.
  • Changed webhook-event-types.list
    Added optional field pagination.totalCount to the webhook-event-types.list response.
  • Changed whatsapp-accounts.list
    Added optional field pagination.totalCount to the whatsapp-accounts.list response.
  • Changed workspaces.list
    Added optional field pagination.totalCount to the workspaces.list response.

More