{"openapi":"3.0.4","info":{"title":"Kenso API: Contact imports","version":"1.1","description":"The Contact imports endpoints of the Kenso API, with every component they use. The full spec is https://api.ken.so/v1/docs/openapi.json. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`."},"servers":[{"url":"https://api.ken.so"}],"security":[{"Bearer":[]}],"tags":[{"name":"contact-imports","description":"Contact imports add people in bulk to a campaign, or to the workspace's people: from a CSV file, a Google Sheet, an Airtable table, another campaign or segment, a saved list, Kenso Search results, workspace people, event attendees, or LinkedIn and Sales Navigator. An import runs in the background as a `contact_import` job, so poll `GET /v1/jobs/{jobId}?type=contact_import` until it finishes. Before you upload a file, a scan suggests the contact field for each column and checks the rows, and a buyer preview turns a list of companies into the people to add.","x-displayName":"Contact imports"}],"paths":{"/v1/contact-imports":{"post":{"tags":["contact-imports"],"summary":"Start a contact import","description":"Adds people to a campaign from one source and answers `202` with a `contact_import` job. The import runs\nin the background, so poll `GET /v1/jobs/{jobId}?type=contact_import` until the job finishes. Every source\nruns the same checks: dedupe, the blocklist and the contact limits. For an import into a campaign, the job's\n`skipped` counts the rows Kenso left out, by reason.\n            \nSend a CSV file as `multipart/form-data`, and every other source as a JSON body with `campaignId` and\n`source`. Each source reads these fields:\n            \n- `csv`: `file`, a CSV file of at most 400 MB and 100,000 rows, with the column names in row 1.\n  `columnMappings` picks the contact field of each column. The form fields `importLimit` (a whole\n  number above 0) and `tagIds` (a JSON array of 1 to 50 tag ids, such as `[3,4]`) work as for source\n  `search`. Where the `csv_import_check` feature is on, `fixes`, `includeRecentlyContacted`\n  and `cleanup` apply the choices of a scan.\n- `campaign`: `sourceCampaignId`, another campaign of the workspace. Kenso copies its contacts.\n- `segment`: `sourceSegmentId`, a segment of any campaign in the workspace. Kenso copies it into the\n  campaign as a new segment with the same name.\n- `search`: `contacts`, 1 to 1,000 people found with Kenso Search. Each person of a buyer preview has\n  such a row in its `contact`.\n- `blitz`: `contacts`, 1 to 1,000 rows of the same shape, for people picked in a provider tab of\n  Search.\n- `loopster`: `records`, 1 to 1,000 people picked in a provider tab of Search, each as that search\n  returned it, and the search's `searchId`.\n- `people`: `personIds`, 1 to 1,000 people of the workspace. Needs the `accounts` feature and\n  Accounts view.\n- `event`: `eventId`, an outbound event. Its attendees with an email or a LinkedIn URL become\n  contacts, at most 5,000. Needs the `accounts` and `event_outbound` features and Accounts view.\n- `linkedin_connections`: `connectionIds`, 1 to 1,000 of the workspace's LinkedIn connections. Needs\n  the `linkedin_network` feature and Accounts view.\n- `sales_navigator`: `linkedinAccountId`, a LinkedIn account you connected, and `url`, a Sales\n  Navigator lead search or lead list. One import reads at most 7 pages, about 175 to 350 people. A list Kenso\n  cannot read to the end imports nothing and answers `400 validation_failed` with code\n  `incomplete_read` on `url`. Needs the `sales_navigator` feature.\n- `linkedin_url`: `url`, a LinkedIn post, people search, Sales Navigator search or Sales Navigator\n  lead list. A LinkedIn account you connected reads it in the background. Needs the\n  `linkedin_url_import` feature.\n- `google_sheets`: `spreadsheetId` and an optional `sheet`, read with your own Google\n  connection. At most 100,000 rows, with the column names in row 1. Needs the `google_sheets` feature.\n- `airtable`: `baseId`, `tableId` and an optional `viewId`, read with the workspace's\n  Airtable token. At most 10,000 records. Needs the `airtable` feature.\n- `saved_list`: `savedListId`, with optional `memberFilters` and `roles`. At most 100,000\n  contacts. Needs the `saved_lists` feature.\n            \nA source whose feature is off for you answers like an unknown source, with `400 validation_failed` on\n`source`. Sources `people`, `event` and `linkedin_url` answer `404 not_found` instead.\n            \nWith `target` set to `people`, the rows become people of the workspace instead of campaign contacts,\nand Kenso ignores `campaignId`. This target takes the sources `csv` (send `target` as a form\nfield), `search`, `blitz`, `event`, `linkedin_connections`, `sales_navigator`,\n`google_sheets` and `airtable`. Kenso matches each row to an existing person or creates one, with\nsource `import`. A row needs an email, a LinkedIn URL, or a name with a business company domain. Kenso\nskips the other rows. The job's `personImport` counts the people created, updated and skipped. This target\nneeds the `lead_intake` feature (`404 not_found` while it is off) and Accounts edit. A member who\nworks only their own accounts cannot use it.\n            \nAn option such as `importLimit`, `tagIds` or `copyEmailEnrichment` works only with the sources\nits field description names. Sent with another source, or with `target` `people`, it answers\n`400 validation_failed` on that field. The `segmentId` field is not supported: sources\n`search`, `blitz`, `loopster`, `segment` and `linkedin_connections` refuse it, and the\nother sources ignore it.\n            \nA JSON body can be at most 10 MB. A multipart CSV upload can be at most 400 MB.\n            \nErrors:\n            \n- `400 validation_failed`: a required field is missing or out of range, `source` is unknown, an\n  option does not fit the source, or no row can be imported. `error.details` names the field.\n- `400 unsupported_linkedin_url`: source `linkedin_url` got a URL it cannot import.\n- `400 linkedin_account_required`: source `linkedin_url`, and you have not connected a LinkedIn\n  account.\n- `400 linkedin_account_unavailable`: source `linkedin_url`, and the LinkedIn account is not one you\n  connected, is not connected, or is paused.\n- `400 sales_navigator_required`: source `linkedin_url` got a Sales Navigator URL, and the LinkedIn\n  account has no Sales Navigator.\n- `402 plan_limit_reached`: the import would pass the plan's contact or lead limit. On Kenso Lifetime,\n  `error.refusal` carries the code `LIFETIME_CONTACT_LIMIT_REACHED` when the import would pass the\n  license's contacts (one pool across its workspaces), or, for source `search`,\n  `LIFETIME_PEOPLE_RESULT_LIMIT_REACHED` when it would pass the license's people results for the day, which\n  reset at 00:00 UTC.\n- `402 trial_cap_reached`: source `search` on the Growth trial, and the import would pass the trial's\n  1,000 Kenso database contacts in any 24 hours. `error.refusal` names the cap\n  (`daily_database_export_rows`).\n- `403 permission_denied`: you lack the Accounts access that the source or `target` `people`\n  needs.\n- `404 not_found`: `campaignId` or another id in the body was not found, or a feature that\n  `people`, `event`, `linkedin_url` or `target` `people` needs is off.\n- `409 conflict`: another import into the campaign is in progress, or source `campaign` already\n  copied the same source campaign into it and `allowReimport` is not true.\n- `409 invalid_state`: the LinkedIn account of source `sales_navigator` is not connected, or the\n  Google file is not a Google Sheets spreadsheet.\n- `409 sales_navigator_required`: source `sales_navigator`, and the LinkedIn account has no Sales\n  Navigator.\n- `409 reconnect_required`: source `google_sheets`, and your Google connection is missing or expired.\n- `409 sheet_not_shared`: source `google_sheets`, and the sheet does not exist or was not picked for\n  Kenso with Google Picker.\n- `409 not_connected`: source `airtable` or `loopster`, and the workspace has no working\n  connection to that service.\n- `409 scope_required`: the Airtable token lacks the read scopes or access to the base.\n- `413 validation_failed`: the JSON body is larger than 10 MB.\n- `429 rate_limited`: the workspace used its daily import quota. Retry after the seconds in\n  `Retry-After`. A CSV file of more than 100,000 rows gets the same answer: split the file.\n- `503 service_unavailable`: Kenso could not start a campaign or segment copy right now, or could not\n  reach Kenso Search for a saved list's `roles`. Nothing was imported, so retry.\n- `503 provider_unavailable`: Google Sheets, Airtable or the provider behind a Search tab did not answer.\n  Retry in a minute.\n            \nRequires Campaigns edit and the `import` permission.\n\nRate limit: 480 calls a minute per API key, on top of the workspace limits.","operationId":"contact-imports.create","parameters":[{"name":"Ken-Version","in":"header","description":"The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`.","schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateContactImportBody"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateContactImportFormBody"}}},"required":true},"responses":{"202":{"description":"Accepted","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["linkedin_account_required","linkedin_account_unavailable","sales_navigator_required","unsupported_linkedin_url","unsupported_version","validation_failed","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"402":{"description":"Payment Required","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["plan_limit_reached","trial_cap_reached"]},"403":{"description":"Forbidden","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["permission_denied"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"409":{"description":"Conflict","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["conflict","invalid_state","not_connected","reconnect_required","sales_navigator_required","scope_required","sheet_not_shared"]},"413":{"description":"Content Too Large","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["validation_failed"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["rate_limited"]},"503":{"description":"Service Unavailable","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableError"}}},"x-ken-error-codes":["provider_unavailable","service_unavailable"]}},"x-ken-permission":{"kind":"page","page":"campaigns","access":"edit","features":["import"],"summary":"Campaigns edit and the `import` permission"},"x-ken-rate-limit":{"limit":480,"windowSeconds":60,"per":"api_key"}}},"/v1/contact-imports/buyer-previews":{"post":{"tags":["contact-imports"],"summary":"Preview buyers at a list of companies","description":"Finds the people to contact at each company of a list, matched to a campaign's ideal customer profile (ICP). Use\nit when a file lists companies instead of people: preview the people, drop the ones you do not want, then add the\nrest with `POST /v1/contact-imports`.\n            \nThe body needs `campaignId` and `companies`: from 1 to 50 companies, each with a `name`, a\n`domain` or both, and an optional `key` that the answer echoes back. Send a longer list in parts of 50.\n`perCompany` sets how many people to return per company, from 1 to 3 (default 3). Example body:\n`{ \"campaignId\": 812, \"companies\": [{ \"key\": \"row-2\", \"name\": \"Northwind\", \"domain\": \"northwind.com\" }], \"perCompany\": 3 }`.\n            \nKenso looks up each company in Kenso Search. A company sent with a domain matches the company that owns the\ndomain: the one with the same name at that domain, else the one whose website is the domain's home page. A\ncompany that only has a page under the domain (such as `notion.so/acme`) does not own it, and Kenso never\nmatches by name in its place. A company sent without a domain matches when exactly one company in Kenso Search\nhas its name.\n            \nThe ICP is the people filters of the campaign's active segments: titles, seniority levels, functions, decision\nmakers and exclusions. For each matched company, Kenso lists up to `perCompany` people in the ICP, best\nfirst. When the ICP finds too few, Kenso fills the company from a looser search and marks those people\n`weakMatch`. When the campaign has no ICP, Kenso ranks people by seniority. Each person appears once in the\nwhole answer, even when Kenso Search holds them twice.\n            \nEach kept person's `contact` goes unchanged into the `contacts` of a `POST /v1/contact-imports`\ncall with `source` `search`. Deduplication, the blocklist and lead credits apply there. The preview\nstores nothing and charges nothing. It counts the companies times `perCompany` against the workspace's daily\n`searchBrowseRows` quota, the same quota Search results use. A company Kenso Search does not answer for in\ntime comes back `failed`: send it again.\n            \nErrors:\n            \n- `400 validation_failed`: `campaignId` is missing, `companies` is empty or holds more than 50,\n  a company has neither a name nor a domain (the error names `companies[i]`), or `perCompany` is less\n  than 1 or more than 3.\n- `404 not_found`: the campaign is not in the workspace.\n- `429 quota_exceeded`: the request would pass the workspace's `searchBrowseRows` quota. Wait for the\n  `Retry-After` seconds.\n            \nRequires Campaigns edit and the `import` permission.\n\nRate limit: 240 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `csv_buyer_preview` feature on your workspace. Until it is on, calls answer 404.","operationId":"contact-imports.buyer-preview","parameters":[{"name":"Ken-Version","in":"header","description":"The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`.","schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBuyerPreviewRequest"}}}},"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuyerPreviewResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","validation_failed","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["quota_exceeded","rate_limited"]}},"x-ken-features":["csv_buyer_preview"],"x-ken-permission":{"kind":"page","page":"campaigns","access":"edit","features":["import"],"summary":"Campaigns edit and the `import` permission"},"x-ken-rate-limit":{"limit":240,"windowSeconds":60,"per":"api_key"}}},"/v1/contact-imports/scans":{"post":{"tags":["contact-imports"],"summary":"Scan an import file","description":"Suggests the contact field for each column of an import file, from its header row and a few sample rows. Send\n`keys` as well to run the list check: it reads every row and reports the rows the import skips anyway and the\nrisky rows you can drop. Call it before you import a CSV file, a Google Sheet or an Airtable table with\n`POST /v1/contact-imports`, or before you upload a file to a saved list.\n            \nThe body needs `source` (`csv`, `google_sheets` or `airtable`), `headers` (from 1 to 200\ncolumn names, each at most 500 characters) and up to 200 `sampleRows` (each cell at most 2,000 characters).\n`target` says where the rows go:\n            \n- `campaign` (the default) needs `campaignId`.\n- `people` suggests only the fields a people import stores and runs no list check.\n- `saved_list` needs `savedListId` for an existing list or `savedListKind` for a list you have not\n  created yet, never both. It also needs Search view and the `saved_lists` feature on the workspace.\n            \nThe list check runs for `campaign` and `saved_list` when you send `keys`: the key columns of every\nrow, one list per column, all of the same length from 1 to 25,000. `keys.rowCount` is the file's row count and\nmust be at least that length. For a larger file, send its first 25,000 rows and the full row count. The check then\nsays `truncated`. A scan that sends `keys` skips the AI suggestions. To get both, scan once without\n`keys` to map the columns, then again with `keys` filled from the mapped columns. Example body:\n<c>{ \"source\": \"csv\", \"campaignId\": 42, \"headers\": [\"Full Name\", \"Work contact\"], \"sampleRows\": [[\"Ada Lovelace\",\n\"ada@example.com\"]], \"keys\": { \"rowCount\": 1, \"fullName\": [\"Ada Lovelace\"], \"email\": [\"ada@example.com\"] } }</c>.\n            \nPass the answer on to the import. Each column's `csvColumn`, `targetField` and `customVariableName`\nare the fields of a `columnMappings` entry of `POST /v1/contact-imports`. For a campaign, send the keys of\nthe checks you keep on in the import's `fixes` form field (a JSON array), send\n`includeRecentlyContacted=true` to keep the rows in `contacted`, and send `cleanup` with the value of\n`cleanupApplied`. The import applies none of them unless you send them. For a saved list, send `fixes` and\n`cleanup` the same way to `POST /v1/saved-lists/{savedListId}/uploads`.\n            \nThe scan stores nothing and charges nothing. The list check reads only data Kenso already has and runs no paid\nlookup. Each call counts against the workspace's `contactImportScans` quota: 30 a minute, 600 an hour and\n5,000 a day.\n            \nErrors:\n            \n- `400 validation_failed`: a body field breaks a rule above. The error names the field.\n- `403 permission_denied`: `target` is `saved_list` and the caller lacks Search view.\n- `404 not_found`: the campaign is not in the workspace, the saved list is not one of the workspace's own lists\n  (a list shared from elsewhere, a library list or another member's private list), or `target` is\n  `saved_list` while the `saved_lists` feature is off.\n- `429 quota_exceeded`: the workspace used up its scans for now. Wait for the `Retry-After` seconds.\n            \nRequires Campaigns view and the `import` permission.\n\nRate limit: 60 calls a minute per API key, on top of the workspace limits.\n\nNeeds the `csv_import_check` feature on your workspace. Until it is on, calls answer 404.","operationId":"contact-imports.scan","parameters":[{"name":"Ken-Version","in":"header","description":"The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions.","schema":{"enum":["2026-11-02","1.1"],"type":"string"},"examples":{"default":{"value":"2026-11-02","x-disabled":false}}},{"name":"X-Ken-Workspace-Id","in":"header","description":"The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`.","schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactImportScanRequest"}}}},"responses":{"200":{"description":"OK","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactImportScanResponse"}}}},"400":{"description":"Bad Request","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["unsupported_version","validation_failed","workspace_required"]},"401":{"description":"Unauthorized","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"x-ken-error-codes":["unauthenticated"]},"403":{"description":"Forbidden","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["permission_denied"]},"404":{"description":"Not Found","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Failure"}}},"x-ken-error-codes":["not_found"]},"429":{"description":"Too Many Requests","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimit-Limit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimit-Remaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}},"text/plain":{"schema":{"$ref":"#/components/schemas/RateLimitedText"}}},"x-ken-error-codes":["quota_exceeded","rate_limited"]}},"x-ken-features":["csv_import_check"],"x-ken-permission":{"kind":"page","page":"campaigns","access":"view","features":["import"],"summary":"Campaigns view and the `import` permission"},"x-ken-rate-limit":{"limit":60,"windowSeconds":60,"per":"api_key","summary":"30 requests a minute, 600 an hour and 5,000 a day per workspace (Free plan: 3 a minute, 60 an hour and 500 a day)","quotas":[{"policy":"contactImportScans","per":"workspace","limits":[{"limit":30,"windowSeconds":60},{"limit":600,"windowSeconds":3600},{"limit":5000,"windowSeconds":86400}],"plans":[{"plan":"Free","limits":[{"limit":3,"windowSeconds":60},{"limit":60,"windowSeconds":3600},{"limit":500,"windowSeconds":86400}]}]}]}}}},"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Enter: Bearer {your Kenso API key}. Create one in the Kenso app under Settings > Integrations > API Keys.","scheme":"bearer","bearerFormat":"Opaque API key"}},"headers":{"RateLimit-Limit":{"description":"The request limit of the rate limit this request is closest to reaching: your plan's limit for this kind of call, your API key's own limit, or the operation's own limit, whichever has the fewest requests left.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"The requests left under that limit. `0` on a `429`.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"The seconds until that limit resets.","schema":{"type":"integer"}}},"schemas":{"ApiKeyError":{"required":["error"],"type":"object","properties":{"error":{"type":"string","description":"A sentence for people that says what went wrong. It can change, so do not parse it."}},"additionalProperties":false,"description":"The body the API key check in front of the operations answered until November 2026, instead of the error body (`Failure`): `{ \"error\": \"Invalid or revoked API key\" }` on a `401`, `{ \"error\": \"Rate limit exceeded\" }` on a `429` and `{ \"error\": \"Authentication is temporarily unavailable\" }` on a `503`. It has no `code`, so branch on the HTTP status."},"BuyerPreview":{"type":"object","properties":{"icp":{"type":"array","items":{"type":"string"},"description":"The campaign's ideal customer profile (ICP) that the people were matched to, as display labels such as\n`Decision makers`. Empty when the campaign has no ICP."},"companies":{"type":"array","items":{"$ref":"#/components/schemas/BuyerPreviewCompany"},"description":"One entry per company sent, in the order sent."}},"additionalProperties":false,"description":"The people Kenso Search finds at each company of the list, matched to the campaign's ICP."},"BuyerPreviewCompany":{"type":"object","properties":{"key":{"type":"string","description":"The `key` you sent with the company, else null.","nullable":true},"input":{"allOf":[{"$ref":"#/components/schemas/BuyerPreviewInput"}],"description":"The name and domain you sent."},"status":{"type":"string","description":"How the lookup went. `matched`: Kenso Search found the company, though `people` can still be empty.\n`unmatched`: no company in Kenso Search fits, and `unmatchedReason` says why. `failed`: Kenso\nSearch did not answer in time, so send the company again."},"unmatchedReason":{"type":"string","description":"Why the company is `unmatched` or `failed`, such as `acme.com is not in Kenso Search`,\n`could not match notion.so: no company in Kenso Search has it as its own website` or\n`no domain, name matches 3 companies`. Null when `matched`.","nullable":true},"company":{"allOf":[{"$ref":"#/components/schemas/BuyerPreviewCompanyFacts"}],"description":"The company Kenso Search matched. Null unless `status` is `matched`."},"signal":{"allOf":[{"$ref":"#/components/schemas/BuyerPreviewSignal"}],"description":"The company's latest hiring, funding or leadership change from the last 90 days. Null when there is none."},"people":{"type":"array","items":{"$ref":"#/components/schemas/BuyerPreviewPerson"},"description":"The people found, best first, at most `perCompany`. Empty unless `status` is `matched`. A person\nalready listed at an earlier company is not listed again."}},"additionalProperties":false,"description":"One company of the list and the people found there."},"BuyerPreviewCompanyFacts":{"type":"object","properties":{"kenCompanyId":{"type":"integer","description":"The company's id in Kenso Search.","format":"int64"},"name":{"type":"string","description":"The company's name in Kenso Search."},"domain":{"type":"string","description":"The company's domain, such as `northwind.com`. Null when unknown.","nullable":true},"employeeCount":{"type":"integer","description":"The company's number of employees. Null when unknown.","format":"int32","nullable":true},"industry":{"type":"string","description":"The company's industry. Null when unknown.","nullable":true}},"additionalProperties":false,"description":"The company Kenso Search matched."},"BuyerPreviewCompanyInput":{"type":"object","properties":{"key":{"type":"string","description":"Your own label for the company, such as its row in your file. The answer echoes it back. Optional.","nullable":true},"name":{"type":"string","description":"The company name. Kenso uses the first 200 characters. A company needs a name, a domain or both.","nullable":true},"domain":{"type":"string","description":"The company's domain or website, such as `northwind.com`. Kenso reads a URL as its registrable domain, so\n`https://www.eu.northwind.com/about` reads as `northwind.com`.","nullable":true}},"additionalProperties":false,"description":"One company to search, as your file has it."},"BuyerPreviewInput":{"type":"object","properties":{"name":{"type":"string","description":"The name you sent, else null.","nullable":true},"domain":{"type":"string","description":"The domain you sent, else null.","nullable":true}},"additionalProperties":false,"description":"The name and domain of a company, as sent."},"BuyerPreviewPerson":{"type":"object","properties":{"kenPersonId":{"type":"integer","description":"The person's id in Kenso Search.","format":"int64"},"fullName":{"type":"string","description":"The person's full name."},"title":{"type":"string","description":"The person's current job title. Null when unknown.","nullable":true},"seniorityLevel":{"type":"string","description":"The person's seniority level as Kenso Search labels it. Null when unknown.","nullable":true},"function":{"type":"string","description":"The person's job function as Kenso Search labels it. Null when unknown.","nullable":true},"linkedInUrl":{"type":"string","description":"The person's LinkedIn profile URL. Null when unknown.","nullable":true},"reason":{"type":"string","description":"Why Kenso picked this person, in one sentence under 90 characters."},"weakMatch":{"type":"boolean","description":"True when the campaign's ICP found too few people and Kenso loosened the search to fill the company."},"contact":{"allOf":[{"$ref":"#/components/schemas/SearchContact"}],"description":"The person as a contact for `POST /v1/contact-imports` with `source` `search`. To add the people\nyou keep, send their `contact` objects unchanged in `contacts`."}},"additionalProperties":false,"description":"A person found at a company."},"BuyerPreviewResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/BuyerPreview"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"BuyerPreviewSignal":{"type":"object","properties":{"kind":{"type":"string","description":"The kind of event: `hiring`, `funding` or `leadership_hire`."},"label":{"type":"string","description":"The event in one short line, for display, such as `Series B - $40M - Sep 3`."},"at":{"type":"string","description":"When it happened, in UTC.","format":"date-time"}},"additionalProperties":false,"description":"A recent event at the company."},"ContactImportListCheck":{"required":["always","checks","contacted","noEmailRows","providerMix","rowFlags","titleMix"],"type":"object","properties":{"rows":{"type":"integer","description":"The number of data rows in the file, as sent in `keys.rowCount`.","format":"int32"},"scannedRows":{"type":"integer","description":"The number of rows checked: the length of the `keys` lists.","format":"int32"},"truncated":{"type":"boolean","description":"True when the file has more rows than were checked, so the counts cover only its first `scannedRows` rows."},"cleanupApplied":{"type":"boolean","description":"True when Kenso cleaned every key value first, as the import does with `cleanup=true`. It follows\n`keys.cleanup`."},"always":{"type":"array","items":{"$ref":"#/components/schemas/ListCheckBucket"},"description":"The rows the import skips whatever you choose, one bucket per reason, empty buckets included. A row lands in the\nfirst bucket it matches, in this order. `failedValidation`: no name, or no company name, domain or company\nLinkedIn URL. `missingKey`: no usable email and no LinkedIn URL. `blocklist`: on the workspace\nblocklist. `duplicateInFile`: repeats an earlier row. `duplicateInCampaign`: already in this campaign.\n`duplicateInOtherCampaign`: already in another campaign. For a saved list the buckets are what its upload\ndoes with a row anyway. `missingKey`: the upload rejects the row because it has no LinkedIn URL, no email and\nno name with a company domain (for a companies list, no company domain or company page).\n`duplicateInFile` and `duplicateInList`: the row merges into an earlier row's member or into a member\nalready on the list, and its addresses join that member."},"contacted":{"allOf":[{"$ref":"#/components/schemas/ListCheckContacted"}],"description":"The rows another campaign emailed within this campaign's recently emailed window. The import skips them unless\nyou send `includeRecentlyContacted=true`. Empty for a saved list."},"checks":{"type":"array","items":{"$ref":"#/components/schemas/ListCheckItem"},"description":"The optional fixes, one per key, in this order. `invalidEmail`: Kenso knows the address is invalid, or the\nfile's validity column says so. `noMx`: the email domain takes no mail. `catchAll`: the domain accepts\nevery address. `personalEmail`: a personal address such as Gmail or Outlook.com. `roleAddress`: a shared\naddress such as info@ or sales@. `companyContacted`: someone else at the company got an email from this\nworkspace within `companyContactedDays`. `companyCap`: the rows after the first `companyCap` at\none company. For a saved list the fixes are `blocklist` (an address, its domain or the company domain is on\nthe workspace blocklist), `invalidEmail`, `noMx`, `catchAll`, `personalEmail` and\n`roleAddress`. A saved list ignores the file's validity column."},"rowFlags":{"type":"array","items":{"type":"array","items":{"type":"integer","format":"int32"}},"description":"One `[rowIndex, mask]` pair for each row with at least one mark, rows in an `always` bucket left out.\n`rowIndex` counts from 0 into the `keys` lists. The mask adds up these bits: 1 `contacted`, 2\n`invalidEmail`, 4 `noMx`, 8 `catchAll`, 16 `roleAddress`, 32 `personalEmail`, 64\n`companyContacted`, 128 `companyCap` and 256 `blocklist` (saved list only)."},"noEmailRows":{"type":"array","items":{"type":"integer","format":"int32"},"description":"The rows outside the `always` buckets that have no usable email, as indexes counting from 0 into the\n`keys` lists. They send no email, so the bounce estimate leaves them out."},"baselinePrior":{"type":"number","description":"The expected hard bounce rate of a row with an email that no email check marks, from 0 to 1.","format":"double"},"bounce":{"allOf":[{"$ref":"#/components/schemas/ListCheckBounce"}],"description":"The expected hard bounce rate of the rows added with an email. Null when no row has an email."},"willAdd":{"type":"integer","description":"The rows the import adds with the default choices: every check whose `defaultOn` is true sent in\n`fixes`, and the `contacted` rows skipped. For a saved list, the members the list gains.","format":"int32"},"companyContactedDays":{"type":"integer","description":"The window of the `companyContacted` check, in days: the campaign's recently emailed window, else 90. 0 for a\nsaved list.","format":"int32"},"companyCap":{"type":"integer","description":"How many rows per company the `companyCap` fix keeps. 0 for a saved list.","format":"int32"},"domainsChecked":{"type":"integer","description":"How many of the `domainsTotal` email domains Kenso has mailbox data for.","format":"int32"},"domainsTotal":{"type":"integer","description":"The number of distinct email domains among the rows outside the `always` buckets.","format":"int32"},"titleMix":{"type":"array","items":{"$ref":"#/components/schemas/ListCheckShare"},"description":"The title mix of the rows outside the `always` buckets. Labels are `C-level or Founder`, `VP`,\n`Director`, `Head or Manager` and `Other`. Shares are whole percents that add up to 100, and a\nlabel with no rows is left out."},"providerMix":{"type":"array","items":{"$ref":"#/components/schemas/ListCheckShare"},"description":"The mailbox provider mix of those rows that have an email. Labels are `Google`, `Microsoft`,\n`Other` and `Unknown`, with shares as in `titleMix`."}},"additionalProperties":false,"description":"The list check: the rows the import skips anyway, the rows recently emailed by another campaign, and the optional\nfixes for risky rows."},"ContactImportMemberFiltersBody":{"type":"object","properties":{"country":{"type":"string","description":"Keeps members in this country, matched exactly. At most 200 characters.","nullable":true},"seniority":{"type":"string","description":"Keeps members with this seniority, matched exactly. At most 200 characters.","nullable":true},"title":{"type":"string","description":"Keeps members whose job title contains this text, ignoring case. At most 200 characters.","nullable":true},"industry":{"type":"string","description":"Keeps members in this industry, matched exactly. At most 200 characters.","nullable":true},"headcountBand":{"type":"string","description":"Keeps members whose company is in this headcount band, matched exactly. At most 200 characters.","nullable":true},"hasSendableEmail":{"type":"boolean","description":"When `true`, keeps only members with a sendable email. When `false`, keeps only those without one.","nullable":true}},"additionalProperties":false,"description":"Filters that narrow the members of a saved list to import. A null or empty field does not filter."},"ContactImportScan":{"required":["columns","listKind"],"type":"object","properties":{"columns":{"type":"array","items":{"$ref":"#/components/schemas/ContactImportScanColumn"},"description":"One suggestion per header, in header order."},"listKind":{"type":"string","description":"What a row of the file stands for. `company` when no column maps to `email`, `profile_url`,\n`first_name`, `last_name` or `full_name` and at least one maps to `company_name`,\n`company_domain` or `company_linkedin_url`. Otherwise `people`."},"check":{"allOf":[{"$ref":"#/components/schemas/ContactImportListCheck"}],"description":"The list check of every row, against the campaign or the saved list. Null when the scan sent no `keys` or\n`target` is `people`."}},"additionalProperties":false,"description":"The result of a scan: a suggested field for each column, and the list check when keys were sent."},"ContactImportScanColumn":{"required":["confidence","csvColumn","reason","samples","targetField"],"type":"object","properties":{"index":{"type":"integer","description":"The column's position in the header row, starting at 0.","format":"int32"},"csvColumn":{"type":"string","description":"The column's header, as sent."},"targetField":{"type":"string","description":"The suggested contact field key, such as `email`, `full_name` or `profile_url`. It can also be\n`custom_variable` (import the column as a custom variable) or `skip` (do not import it). Each field is\nsuggested for one column at most, except `email`, `email_validity` and `custom_variable`. With\n`target` `people`, only `email`, `first_name`, `last_name`, `full_name`,\n`title`, `company_name`, `company_domain`, `phone_number`, `profile_url` and `skip`."},"customVariableName":{"type":"string","description":"The custom variable's name when `targetField` is `custom_variable`, else null.","nullable":true},"confidence":{"type":"string","description":"How sure the suggestion is. `high`: the header names the field, or nearly every value is one.\n`memory`: this workspace mapped the same header to this field before. `check`: likely, so confirm it.\n`skip`: the column is not imported."},"reason":{"type":"string","description":"Why Kenso suggests this field, in one short sentence."},"samples":{"type":"array","items":{"type":"string"},"description":"Up to 3 distinct values from the column's sample rows, blanks left out, each at most 120 characters."},"cleanup":{"type":"string","description":"What the import's cleanup would change in this column's sample values, such as <c>Cleans 3 of 10 sample values\n(casing, format)</c>. Null when nothing changes or Kenso has no cleanup for the field.","nullable":true}},"additionalProperties":false,"description":"The suggested field for one column of the file."},"ContactImportScanKeys":{"type":"object","properties":{"rowCount":{"type":"integer","description":"The number of data rows in the file, at least the length of the lists. A larger number means the lists hold only\nthe first rows of the file, and the check says `truncated`.","format":"int32"},"cleanup":{"type":"boolean","description":"Whether Kenso cleans every value first, as the import does with `cleanup=true`. Omitted means true for a\ncampaign and false for a saved list, since a saved list upload cleans only when you send `cleanup=true`.","nullable":true},"email":{"type":"array","items":{"type":"string"},"description":"The cells of the first column mapped to `email`.","nullable":true},"profileUrl":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `profile_url`, the person's LinkedIn URL.","nullable":true},"companyDomain":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `company_domain`.","nullable":true},"companyName":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `company_name`.","nullable":true},"companyLinkedinUrl":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `company_linkedin_url`.","nullable":true},"firstName":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `first_name`.","nullable":true},"lastName":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `last_name`.","nullable":true},"fullName":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `full_name`.","nullable":true},"title":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `title`.","nullable":true},"emailValidity":{"type":"array","items":{"type":"string"},"description":"The cells of the column mapped to `email_validity` for the first email column. For a campaign, a cell that\nsays `invalid` or `undeliverable` marks the row's email invalid, and a catch-all status marks it\ncatch-all. A saved list ignores it.","nullable":true},"otherEmails":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"One list for each further column mapped to `email`, in mapping order, at most 10. The import keeps every\nvalid address of a row, so the blocklist and duplicate checks read them all.","nullable":true},"otherEmailValidity":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"The `email_validity` column mapped right after each list in `otherEmails`, in the same order. Null where\nthat email column has no validity column. It holds no more lists than `otherEmails`.","nullable":true}},"additionalProperties":false,"description":"The key columns of every data row for the list check. Each list holds one column's cells in row order, so index 0 of\nevery list is the first data row. Send a list only for a column you mapped to that field. When `target` is\n`campaign` or `saved_list`, every list you send has the same length, from 1 to 25,000."},"ContactImportScanRequest":{"required":["source"],"type":"object","properties":{"source":{"type":"string","description":"Where the file comes from: `csv`, `google_sheets` or `airtable`. Required."},"target":{"type":"string","description":"Where the rows go: `campaign`, `people` (workspace people, only the fields a people import stores) or\n`saved_list`. Omitted means `campaign`.","nullable":true},"campaignId":{"type":"integer","description":"The campaign the file goes into. Required when `target` is `campaign`.","format":"int64","nullable":true},"savedListId":{"type":"integer","description":"The saved list the file goes into, when `target` is `saved_list`. It must be one of the workspace's own\nlists that the caller can see. Send this or `savedListKind`, not both.","format":"int64","nullable":true},"savedListKind":{"type":"string","description":"The kind of a saved list you have not created yet: `people` or `companies`. Send it instead of\n`savedListId` when `target` is `saved_list`. Kenso reads the rows as a new list of that kind would.","nullable":true},"headers":{"type":"array","items":{"type":"string"},"description":"The file's header row: from 1 to 200 column names, each at most 500 characters.","nullable":true},"sampleRows":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":"Up to 200 data rows, each a list of cells in header order. Each cell is at most 2,000 characters. Kenso reads a\nmissing cell at the end of a short row as blank and ignores cells past the last header.","nullable":true},"keys":{"allOf":[{"$ref":"#/components/schemas/ContactImportScanKeys"}],"description":"The key columns of every row, for the list check. Kenso runs the check when `target` is `campaign` or\n`saved_list`. Sending it skips the AI suggestions."}},"additionalProperties":false,"description":"An import file's header row and sample rows to scan, with optional key columns for the list check."},"ContactImportScanResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/ContactImportScan"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"ContactImportSkips":{"type":"object","properties":{"duplicateInCampaign":{"type":"integer","description":"Rows that match a contact already in this campaign.","format":"int32"},"duplicateInOtherCampaign":{"type":"integer","description":"Rows that match a contact in another campaign of the workspace, skipped because this campaign removes duplicates\nacross campaigns.","format":"int32"},"duplicateInSource":{"type":"integer","description":"Rows that repeat an earlier row of the same import.","format":"int32"},"alreadyContacted":{"type":"integer","description":"Rows that match a contact emailed within the campaign's recently emailed window.","format":"int32"},"blocklist":{"type":"integer","description":"Rows that match the workspace's blocklist.","format":"int32"},"failedValidation":{"type":"integer","description":"Rows that failed row checks, such as a row with no first and last name or no company name or domain.","format":"int32"},"salesNavigatorProfileUnresolved":{"type":"integer","description":"Sales Navigator people Kenso could not turn into a LinkedIn profile URL, so no LinkedIn step could reach them.","format":"int32"},"other":{"type":"integer","description":"Rows skipped for any other reason, such as a row Kenso could not process.","format":"int32"},"missingKey":{"type":"integer","description":"Rows with no email and no LinkedIn URL, dropped by the `missingKey` List check fix.","format":"int32"},"invalidEmail":{"type":"integer","description":"Rows whose email Kenso knows is invalid, dropped by the `invalidEmail` List check fix.","format":"int32"},"noMx":{"type":"integer","description":"Rows whose email domain takes no mail (no MX record), dropped by the `noMx` List check fix.","format":"int32"},"catchAll":{"type":"integer","description":"Rows whose email domain accepts every address, dropped by the `catchAll` List check fix.","format":"int32"},"personalEmail":{"type":"integer","description":"Rows with a personal email address, such as Gmail or Outlook.com, dropped by the `personalEmail` List check fix.","format":"int32"},"roleAddress":{"type":"integer","description":"Rows with a role address such as info@ or sales@, dropped by the `roleAddress` List check fix.","format":"int32"},"companyContacted":{"type":"integer","description":"Rows at a company where someone else recently got a Kenso email, dropped by the `companyContacted` List check fix.","format":"int32"},"companyCap":{"type":"integer","description":"Rows past the first 5 people at one company, dropped by the `companyCap` List check fix.","format":"int32"}},"additionalProperties":false,"description":"Rows a campaign contact import skipped, with each row counted under one reason."},"CreateBuyerPreviewRequest":{"required":["campaignId"],"type":"object","properties":{"campaignId":{"type":"integer","description":"The campaign whose ideal customer profile the people are matched to. Required.","format":"int64"},"companies":{"type":"array","items":{"$ref":"#/components/schemas/BuyerPreviewCompanyInput"},"description":"The companies to search, from 1 to 50. Each needs a `name`, a `domain` or both.","nullable":true},"perCompany":{"type":"integer","description":"The most people to return per company, from 1 to 3. Omitted means 3.","format":"int32","nullable":true}},"additionalProperties":false,"description":"A list of companies to find buyers at, for one campaign."},"CreateContactImportBody":{"type":"object","properties":{"campaignId":{"type":"integer","description":"The campaign to import into. Required unless `target` is `people`, which ignores it.","format":"int64"},"source":{"type":"string","description":"Where the rows come from: `campaign`, `segment`, `search`, `blitz`, `loopster`,\n`people`, `event`, `linkedin_connections`, `sales_navigator`, `linkedin_url`,\n`google_sheets`, `airtable` or `saved_list`. A CSV file uses the multipart body instead.","nullable":true},"target":{"type":"string","description":"What the import creates. With `campaign` (the default), the rows become contacts of `campaignId`. With\n`people`, they become people of the workspace instead, which needs the `lead_intake` feature and\nAccounts edit.","nullable":true},"sourceCampaignId":{"type":"integer","description":"Source `campaign`: the campaign of this workspace to copy contacts from. Required with that source, and it\nmust differ from `campaignId`.","format":"int64","nullable":true},"segmentId":{"type":"integer","description":"Not supported. Sources `search`, `blitz`, `loopster`, `segment` and\n`linkedin_connections` answer `400 validation_failed` when it is set, and the other sources ignore it.","format":"int64","nullable":true},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/SearchContact"},"description":"Source `search` or `blitz`: 1 to 1,000 people to add. For a campaign, a row needs a first and last name\n(or a `fullName` Kenso can split) and a company name, domain or LinkedIn URL, and Kenso skips the other rows.","nullable":true},"searchId":{"type":"string","description":"Source `loopster`: the `meta.searchId` of the search the `records` came from, at most 200\ncharacters. Required when a record has no LinkedIn URL: Kenso builds a temporary table from that search in the\nworkspace's connected account to read the missing URLs, then moves the table to the trash.","nullable":true},"records":{"type":"array","items":{"$ref":"#/components/schemas/LoopsterImportRecordRequest"},"description":"Source `loopster`: 1 to 1,000 people picked in a provider tab of Search, each as that search returned it.","nullable":true},"personIds":{"type":"array","items":{"type":"integer","format":"int64"},"description":"Source `people`: 1 to 1,000 people of the workspace, each added with their name, email, title, LinkedIn URL\nand the company of their highest-priority account. Ids outside the workspace, or outside your own accounts when\nyou work only those, are left out. A person who came from a Kenso library list answers\n`400 validation_failed` with code `library_origin`: import their saved list instead.","nullable":true},"eventId":{"type":"integer","description":"Source `event`: the outbound event whose attendees become contacts. Kenso adds only attendees with an email or\na LinkedIn URL, at most 5,000. A larger event answers `400 validation_failed` on this field, so send\n`roles` to import one role at a time.","format":"int64","nullable":true},"roles":{"type":"array","items":{"type":"string"},"description":"Source `event`: the attendee roles to import, from `attendee`, `exhibitor`, `speaker` and\n`sponsor`. Omitted imports every role. Source `saved_list` with a company list: up to 20 job titles of\nat most 100 characters each. Kenso Search then adds up to 5 people with those titles per company, for at most 500\ncompanies, and a company where it finds nobody becomes one company contact.","nullable":true},"includeAccounts":{"type":"boolean","description":"Source `event`: `true` also adds attendees whose company is an account of the workspace. If you work\nonly your own accounts, you get only the attendees on those. Default `false`.","nullable":true},"connectionIds":{"type":"array","items":{"type":"integer","format":"int64"},"description":"Source `linkedin_connections`: 1 to 1,000 ids of the workspace's LinkedIn connections. Each becomes a contact\nwith name, title, headline, LinkedIn URL, seniority, and the company's name, domain, LinkedIn URL, industry and\nsize. Ids outside the workspace are left out.","nullable":true},"linkedinAccountId":{"type":"integer","description":"Source `sales_navigator`: the LinkedIn account that reads `url`, one you connected yourself with Sales\nNavigator. Required. Source `linkedin_url`: optional. Omitted, Kenso uses your first connected account that\nfits the URL.","format":"int64","nullable":true},"url":{"type":"string","description":"Source `sales_navigator`: a Sales Navigator lead search or lead list URL. Source `linkedin_url`: a\nLinkedIn post, people search, Sales Navigator search or Sales Navigator lead list URL. At most 8,000 characters.","nullable":true},"spreadsheetId":{"type":"string","description":"Source `google_sheets`: the spreadsheet id, or its Google Sheets URL. Required.","nullable":true},"sheet":{"type":"string","description":"Source `google_sheets`: the title of the sheet (tab) to read. Omitted reads the first sheet.","nullable":true},"baseId":{"type":"string","description":"Source `airtable`: the Airtable base id, which starts with `app`. Required.","nullable":true},"tableId":{"type":"string","description":"Source `airtable`: the table id (it starts with `tbl`) or name. Required. Its field names, primary field\nfirst, are the column names, and each record is one row of cell text.","nullable":true},"viewId":{"type":"string","description":"Source `airtable`: a view id (it starts with `viw`) or name, to import only the view's records. Omitted\nreads the whole table. A table or view of more than 10,000 records answers `400 validation_failed` on\n`tableId`, so import a large table in parts through views.","nullable":true},"columnMappings":{"type":"array","items":{"$ref":"#/components/schemas/CsvColumnMapping"},"description":"Source `google_sheets` or `airtable`: which column feeds which contact field, as for a CSV upload.\nOmitted, Kenso maps the columns by their names. Source `saved_list` refuses it: the list sets its own columns.","nullable":true},"maxLeads":{"type":"integer","description":"Source `linkedin_url`: the most people to import. From 1 to 2,000 for a post, to 1,000 for a people search and\nto 2,500 for a Sales Navigator URL. Default 500.","format":"int32","nullable":true},"postKinds":{"type":"array","items":{"type":"string"},"description":"Source `linkedin_url` with a post URL: whom to import, `reaction`, `comment` or both. Omitted\nimports both.","nullable":true},"savedListId":{"type":"integer","description":"Source `saved_list`: the list whose members Kenso imports. It can be a list of this workspace (a private list\nonly for its owner), a list shared with the workspace, or a library list. Members this list already added to the\ncampaign are skipped, so a retry adds only the rest. On a paid plan, an email a library list already verified as\nSafe arrives Safe with no email charge. A Free workspace gets no emails from a library list, and a member copied\nout of a library list follows the same rules in any list.","format":"int64","nullable":true},"memberFilters":{"allOf":[{"$ref":"#/components/schemas/ContactImportMemberFiltersBody"}],"description":"Source `saved_list`: narrows the members to import. More than 100,000 matching members answers\n`400 validation_failed` on this field."},"findPeople":{"type":"boolean","description":"Source `saved_list`: must be absent or `false`. To add people at the companies of a company list, send\n`roles`.","nullable":true},"importLimit":{"type":"integer","description":"Source `campaign` or `search`: the most contacts to import, greater than 0. Omitted imports all.","format":"int32","nullable":true},"importOffset":{"type":"integer","description":"Source `campaign`: how many contacts of the source campaign to skip first, 0 or more.","format":"int32","nullable":true},"onlyImportQualifiedContacts":{"type":"boolean","description":"Source `campaign`: `true` copies only the contacts the source campaign qualified. Default `false`.","nullable":true},"onlyImportValidContacts":{"type":"boolean","description":"Source `campaign`: `true` copies only contacts with a valid email. Default `false`.","nullable":true},"deduplicateCampaignIds":{"type":"array","items":{"type":"integer","format":"int64"},"description":"Source `campaign`: 1 to 50 other campaigns of the workspace. Kenso leaves out the people already in any of\nthem. An id outside the workspace answers `404 not_found`.","nullable":true},"deduplicationMode":{"type":"string","description":"Source `campaign`: how Kenso spots a person who is already there. `by_email` (the default) compares\nemail addresses, and `by_data` compares first name, last name and company. `none` turns the check off,\nso the copy can create duplicate contacts.","nullable":true},"allowReimport":{"type":"boolean","description":"Source `campaign`: `true` repeats a finished copy from the same source campaign. Without it, a repeat\nanswers `409 conflict`. Default `false`.","nullable":true},"copyDataEnrichment":{"type":"boolean","description":"Source `campaign`: `true` keeps the source contacts' data enrichment, such as their LinkedIn profile and\nposts. Default `false`.","nullable":true},"copyEmailEnrichment":{"type":"boolean","description":"Source `campaign` or `segment`: `true` keeps the emails Kenso already found for the source\ncontacts. Default `false`.","nullable":true},"triggerPostProcessing":{"type":"boolean","description":"Source `search`: `true` (the default) starts enrichment and the AI steps after the import, and\n`false` skips them.","nullable":true},"tagIds":{"type":"array","items":{"type":"integer","format":"int64"},"description":"Source `search`: 1 to 50 contact tags of the workspace to put on every imported contact.","nullable":true},"sourceSegmentId":{"type":"integer","description":"Source `segment`: the segment to copy, from any campaign of the workspace. Required. Kenso copies it into\n`campaignId` as a new segment with the same name, so a segment of that name already in the campaign answers\n`400 validation_failed`.","format":"int64","nullable":true},"copyQualification":{"type":"boolean","description":"Source `segment`: `true` keeps the source contacts' AI qualification results. Default `false`.","nullable":true},"copyEmailVerification":{"type":"boolean","description":"Source `segment`: `true` keeps the source contacts' email verification results. Default `false`.","nullable":true}},"additionalProperties":false,"description":"The JSON body of a contact import. `source` decides which other fields Kenso reads."},"CreateContactImportFormBody":{"required":["file"],"type":"object","properties":{"file":{"type":"string","description":"The CSV file. Required, not empty, with a `.csv` name. Row 1 holds the column names, and the file can have at\nmost 100,000 rows.","format":"binary"},"campaignId":{"type":"integer","description":"The campaign to import into. Required unless `target` is `people`, which ignores it.","format":"int64"},"source":{"type":"string","description":"Always `csv` for a file upload. You can omit it.","nullable":true},"target":{"type":"string","description":"What the import creates. With `campaign` (the default), the rows become contacts of `campaignId`. With\n`people`, they become people of the workspace instead, which needs the `lead_intake` feature and\nAccounts edit.","nullable":true},"columnMappings":{"type":"string","description":"A JSON array of column mappings that picks the contact field of each column. Omitted, Kenso maps the columns by\ntheir names. A mapping that names a column the header row does not have answers `400 validation_failed`.","nullable":true},"fixes":{"type":"string","description":"A JSON array of the scan's List check fixes to apply: `missingKey`, `invalidEmail`, `noMx`,\n`catchAll`, `personalEmail`, `roleAddress`, `companyContacted` or `companyCap`. Kenso\ndrops the rows the check flags for each fix and counts them under that key in the job's `skipped`. Sending\nthe field at all needs the `csv_import_check` feature (else `400 validation_failed`), and\n`target` `people` refuses it.","nullable":true},"includeRecentlyContacted":{"type":"boolean","description":"When `true`, keeps the rows of people the campaign would skip because they were emailed recently, for this\nimport only. Send it only as `true`: sending the field at all, even as `false`, needs the\n`csv_import_check` feature (else `400 validation_failed`), and `target` `people` refuses it."},"cleanup":{"type":"boolean","description":"When `true`, Kenso cleans the name, email, title, company, domain, LinkedIn URL and phone cells as the scan's\ncleanup notes describe. Send it only as `true`: sending the field at all, even as `false`, needs the\n`csv_import_check` feature (else `400 validation_failed`), and `target` `people` refuses it."}},"additionalProperties":false,"description":"The multipart body of a contact import that uploads a CSV file."},"CsvColumnMapping":{"type":"object","properties":{"csvColumn":{"type":"string","description":"The column's name as row 1 of the file has it. Kenso compares names trimmed and ignoring case."},"targetField":{"type":"string","description":"The contact field the column feeds, as an import key such as `email`, `first_name`, `full_name`,\n`title`, `profile_url` (the LinkedIn URL), `company_name` or `company_domain`. Send\n`custom_variable` to keep the column as a custom variable. A scan suggests the key for each column."},"customVariableName":{"type":"string","description":"With `targetField` `custom_variable`: the custom variable's name. Required for that target.","nullable":true},"useAsAiContext":{"type":"boolean","description":"With `targetField` `custom_variable`: `true` lets the AI steps use the value as context. Omitted, a\nnew variable starts as `true` and an existing one keeps its setting.","nullable":true},"isRequiredForSending":{"type":"boolean","description":"With `targetField` `custom_variable`: `true` holds a contact back from sending until the variable\nhas a value. Omitted, a new variable starts as `false` and an existing one keeps its setting.","nullable":true}},"additionalProperties":false,"description":"Which column of the file feeds which contact field."},"CurrentExperienceImport":{"type":"object","properties":{"companyId":{"type":"integer","description":"Not read by the import.","format":"int64","nullable":true},"companyName":{"type":"string","description":"The company's name. Kenso ignores an entry with neither a name nor a domain.","nullable":true},"companyUrl":{"type":"string","description":"The company's LinkedIn page URL.","nullable":true},"companyDomain":{"type":"string","description":"The company's website domain, such as `example.com`.","nullable":true},"companyEmployeeCount":{"type":"integer","description":"The company's number of employees.","format":"int32","nullable":true},"title":{"type":"string","description":"The person's job title at this company.","nullable":true},"startDate":{"type":"string","description":"When the person started this job, as an ISO 8601 date and time.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"Another job the person holds now, besides the main one."},"ErrorAccount":{"type":"object","properties":{"accountId":{"type":"integer","description":"The account's id.","format":"int64"},"name":{"type":"string","description":"The account's name."},"stakeholderId":{"type":"integer","description":"The person's stakeholder id on this account.","format":"int64"}},"additionalProperties":false,"description":"An account named in an error detail."},"ErrorBody":{"type":"object","properties":{"code":{"type":"string","description":"Stable error code, such as `validation_failed` or `not_found`. Branch on this value."},"message":{"type":"string","description":"A sentence for people that explains the error. It can change, so do not parse it."},"details":{"type":"array","items":{"$ref":"#/components/schemas/ErrorDetail"},"description":"One entry per problem, naming the field or limit it is about. Omitted when there are none.","nullable":true},"requestId":{"type":"string","description":"The id of this request: the same value as the `X-Correlation-Id` response header. Quote it when you write\nto contact@ken.so."},"docUrl":{"type":"string","description":"The page on this code in the developer docs, which says what it means and how to fix it. The errors guide for a\ncode that has no page of its own.","readOnly":true},"refusal":{"allOf":[{"$ref":"#/components/schemas/Refusal"}],"description":"On a `402`, the plan rule or usage limit that refused the request and how to lift it. Omitted otherwise."},"impact":{"allOf":[{"$ref":"#/components/schemas/InvalidationImpact"}],"description":"On a `409` that refuses a change because it would clear stored AI output (a prompt edit, a restore or a\nreset), how much the change would clear. Omitted otherwise."},"surface":{"type":"string","description":"Set only by the voice ticket's `409` (code `voice_conversation_active`): the chat the person's other\nvoice conversation runs in, `support`, `ken` or `onboarding`. Omitted on every other error.","nullable":true}},"additionalProperties":false,"description":"What went wrong in a request."},"ErrorDetail":{"type":"object","properties":{"field":{"type":"string","description":"The request field, header or limit the problem is about, such as `name` or `Ken-Version`."},"code":{"type":"string","description":"Stable code for this problem, such as `required` or `invalid`."},"message":{"type":"string","description":"A sentence for people that explains this problem."},"count":{"type":"integer","description":"On `export_limit_exceeded`, how many rows match the export. Omitted otherwise.","format":"int32","nullable":true},"index":{"type":"integer","description":"The position of the refused item in the request's list. Omitted otherwise.","format":"int32","nullable":true},"limit":{"type":"integer","description":"On `export_limit_exceeded`, the row limit the export ran with. On a `quota_exceeded` detail whose\n`field` names a quota, that quota's limit. On a `rate_limited` detail from your workspace's rate\nlimits, the limit that was hit. Omitted otherwise.","format":"int32","nullable":true},"resetAt":{"type":"string","description":"On some `quota_exceeded` details, when the quota frees up, in UTC. It is the same instant as the top-level\n`quotaResetAt`. On a `rate_limited` detail from your workspace's rate limits, when that limit resets.\nOmitted otherwise.","format":"date-time","nullable":true},"retryAfterSeconds":{"type":"integer","description":"On those `quota_exceeded` details and on most `rate_limited` details, the seconds to wait. It is the\nsame value as the `Retry-After` header. Omitted otherwise.","format":"int32","nullable":true},"inboxId":{"type":"integer","description":"The inbox the problem is about. Omitted otherwise.","format":"int64","nullable":true},"domainId":{"type":"integer","description":"The domain the problem is about. Omitted otherwise.","format":"int64","nullable":true},"domainName":{"type":"string","description":"The name of that domain, or the domain name the request gave. Omitted otherwise.","nullable":true},"accountId":{"type":"integer","description":"On `domain_taken`, `already_stakeholder` and `previously_removed`, the existing account to use\ninstead. Omitted otherwise.","format":"int64","nullable":true},"personId":{"type":"integer","description":"On `email_taken` and `linkedin_url_taken`, the existing person to use instead. Omitted otherwise.","format":"int64","nullable":true},"stakeholderId":{"type":"integer","description":"The account stakeholder the problem is about. Omitted otherwise.","format":"int64","nullable":true},"championId":{"type":"integer","description":"Not used. Always omitted.","format":"int64","nullable":true},"callTaskId":{"type":"integer","description":"On `call_task_exists`, the open call task that already holds the person's slot. Omitted otherwise.","format":"int64","nullable":true},"status":{"type":"string","description":"On `invalid_transition`, the current status. Omitted otherwise.","nullable":true},"allowed":{"type":"array","items":{"type":"string"},"description":"On `out_of_range`, the allowed values. On `invalid_transition`, the statuses the change is allowed\nfrom. Omitted otherwise.","nullable":true},"scope":{"type":"string","description":"On a `permission_denied` for an account owner change, the account scope the call needs (`all`). On\n`sending_paused`, what the pause covers: `inbox`, `domain` or `workspace`. Omitted otherwise.","nullable":true},"removedAt":{"type":"string","description":"On `previously_removed`, when a person removed the stakeholder, in UTC. Omitted otherwise.","format":"date-time","nullable":true},"page":{"type":"string","description":"On `permission_denied`, the page the call needs, such as `campaigns`. Omitted otherwise.","nullable":true},"required":{"type":"string","description":"On `permission_denied`, the access `page` needs: `view` or `edit`. Omitted otherwise.","nullable":true},"feature":{"type":"string","description":"On `permission_denied`, the permission the call needs, such as `launch`. Omitted otherwise.","nullable":true},"runId":{"type":"integer","description":"On `committee_run_active` and `run_not_finding`, the committee run the problem is about. Omitted\notherwise.","format":"int64","nullable":true},"mergedIntoId":{"type":"integer","description":"On `person_merged`, the person the merged person now lives on. On `account_merged`, the account the\nmerged account now lives on. Omitted otherwise.","format":"int64","nullable":true},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/ErrorAccount"},"description":"On `person_on_accounts`, the accounts that block the change. Omitted otherwise.","nullable":true},"stage":{"type":"string","description":"On `stage_in_use` and `system_stage`, the opportunity stage key the problem is about. Omitted otherwise.","nullable":true},"opportunityCount":{"type":"integer","description":"On `stage_in_use`, how many opportunities are in that stage. Omitted otherwise.","format":"int32","nullable":true},"rule":{"type":"string","description":"On `guardrail_violation`, the contact limit rule the change breaks. Omitted otherwise.","nullable":true},"nextAllowedAt":{"type":"string","description":"On `guardrail_violation`, the first `dueAt` that passes every contact limit, in UTC. On a refused\nsend, when to retry. Omitted otherwise, and when waiting does not clear it.","format":"date-time","nullable":true},"fix":{"type":"string","description":"On a refused send, what to do next, in plain words. Omitted otherwise.","nullable":true},"opensAt":{"type":"string","description":"On `outside_calling_hours`, when the person's calling window opens, in UTC. Omitted otherwise.","format":"date-time","nullable":true},"currentVersion":{"type":"integer","description":"On a knowledge file's `version_conflict`, the file's current version. Omitted otherwise.","format":"int32","nullable":true},"provider":{"type":"string","description":"On a CRM connection error (`provider_error`, `exchange_failed`, `already_connected`,\n`account_mismatch` or `provider_unavailable`), the CRM it is about. Omitted otherwise.","nullable":true},"sharedWithMaster":{"type":"boolean","description":"True on a `quota_exceeded` detail when the shared limit of the white-label master workspace was hit, so\n`limit` is the limit of the whole white-label account. Omitted otherwise. The master's id is never sent.","nullable":true},"stepId":{"type":"integer","description":"On `link_reputation_blocked`, the saved sequence step that holds the blocked link. Omitted otherwise, and\nfor a step the save would have created.","format":"int64","nullable":true},"stepOrder":{"type":"integer","description":"On `link_reputation_blocked`, the `stepOrder` of that step. Omitted otherwise.","format":"int32","nullable":true},"url":{"type":"string","description":"On `link_reputation_blocked`, the blocked link as the step's copy writes it. Omitted otherwise.","nullable":true},"key":{"type":"string","description":"On `unfilled_template_key`, the template key the text still holds, such as `first_name` for\n`{first_name}`. Omitted otherwise.","nullable":true},"marker":{"type":"string","description":"On `unfilled_template_key`, that key as the text writes it, such as `{first_name}` or `[company]`.\nOmitted otherwise.","nullable":true},"retryAt":{"type":"string","description":"On a warm path Start's `guardrail_connector_monthly`, `guardrail_account_monthly`,\n`guardrail_connector_cooldown` and `guardrail_handoff_weekly`, when the limit frees up, in UTC. Omitted\notherwise.","format":"date-time","nullable":true},"workspaceId":{"type":"integer","description":"On `last_admin`, a workspace that needs a new admin before the account can be deleted. On\n`new_admin_not_found`, the workspace of the refused choice. Omitted otherwise.","format":"int64","nullable":true},"workspaceName":{"type":"string","description":"On `last_admin`, the name of that workspace. Omitted otherwise.","nullable":true},"class":{"type":"string","description":"On a `rate_limited` detail from your workspace's rate limits, the class of call that hit its limit:\n`read`, `write`, `bulk`, `heavy` or `sensitive`. Omitted otherwise.","nullable":true},"window":{"type":"string","description":"On that detail, the window whose limit was hit: `minute`, `day` or `bulkItemsDay`. Omitted\notherwise.","nullable":true}},"additionalProperties":false,"description":"One problem in an error: the field or limit it is about, a stable `code` and a `message`. The other fields\nappear only with the codes their descriptions name."},"Failure":{"type":"object","properties":{"success":{"type":"boolean","description":"Always false on an error."},"error":{"allOf":[{"$ref":"#/components/schemas/ErrorBody"}],"description":"What went wrong."},"quotaResetAt":{"type":"string","description":"When the quota that refused the request frees up, in UTC. Set on some quota refusals. Omitted otherwise.","format":"date-time","nullable":true},"currentVersion":{"type":"integer","description":"The current revision of a workflow draft, on a draft save's `409 version_conflict`. Read the workflow\nagain, then send this value as `baseVersion`. Omitted otherwise.","format":"int32","nullable":true},"current":{"allOf":[{"$ref":"#/components/schemas/MeetingRepNotesCurrent"}],"description":"Your meeting notes and their version as stored now, on a meeting notes save's `409 version_conflict`.\nMerge your change, then save again with `baseVersion` set to `current.repNotesVersion`. Omitted\notherwise."},"refusal":{"allOf":[{"$ref":"#/components/schemas/Refusal"}],"description":"A copy of `error.refusal`, set on some billing refusals. Omitted otherwise."},"message":{"type":"string","description":"A copy of `error.message`, set together with `refusal`. Omitted otherwise.","nullable":true},"lookalikeSeeds":{"description":"How Kenso read each seed of a lookalike search, on its `422 no_usable_seeds`:\n`{resolved: [{input, companyId, personId, name, domain}], unresolved: [{input, reason}]}`. Use it to show\nwhy no seed was usable. Omitted otherwise."}},"additionalProperties":false,"description":"The body of every error, with a 4xx or 5xx status. Branch on `error.code`."},"InboxImportJob":{"type":"object","properties":{"connectedCount":{"type":"integer","description":"Rows that connected an inbox.","format":"int32"},"failedCount":{"type":"integer","description":"Rows that failed to connect.","format":"int32"},"skippedCount":{"type":"integer","description":"Rows Kenso skipped, such as an inbox the workspace already has.","format":"int32"},"startedAt":{"type":"string","description":"When the import started on its first row, in UTC. Omitted while it waits in the queue.","format":"date-time","nullable":true},"updatedAt":{"type":"string","description":"When the import last made progress, in UTC. An import with no progress for 10 minutes reads `failed`\nwith `error.code` `interrupted`.","format":"date-time"},"completedAt":{"type":"string","description":"When the import finished, in UTC. Omitted until it finishes.","format":"date-time","nullable":true},"rows":{"type":"array","items":{"$ref":"#/components/schemas/InboxImportRow"},"description":"Processed rows in `index` order, empty until the first row has a result. Returned when you create or get\nthe import, and omitted in lists and for a member without Delivery view.","nullable":true}},"additionalProperties":false,"description":"Counts and row results of an inbox import, without any passwords."},"InboxImportRow":{"type":"object","properties":{"index":{"type":"integer","description":"Zero-based position of the row in the request's `rows` array.","format":"int32"},"email":{"type":"string","description":"The row's email address."},"status":{"type":"string","description":"The row's result: `connected`, `failed` or `skipped`."},"inboxId":{"type":"integer","description":"The connected inbox, the existing inbox a skipped row matched, or the disconnected inbox a failed\nconnect left in the workspace. Omitted when there is none.","format":"int64","nullable":true},"errorCode":{"type":"string","description":"Why the row did not connect, omitted for a connected row. A skipped row has `already_exists`,\n`duplicate_in_file`, or `feature_disabled` or `forbidden` when the import stopped before the row\nbecause inbox import was turned off for the workspace or the member who started it lost Delivery edit. A failed\nrow has `email_in_use` (another Kenso inbox has the email), `host_failure_limit` (not tried, because\nits host refused several logins or could not be reached earlier in the import) or an API error code such as\n`validation_failed` or `service_unavailable`.","nullable":true},"message":{"type":"string","description":"A readable message about the row's result, when Kenso has one.","nullable":true},"firstName":{"type":"string","description":"On a connected row that set one in the file, the sender first name now on the mailbox. Omitted otherwise.","nullable":true},"lastName":{"type":"string","description":"On a connected row that set one in the file, the sender last name now on the mailbox. Omitted otherwise.","nullable":true},"dailySendLimit":{"type":"integer","description":"On a connected row that set one in the file, the daily limit now stored on the mailbox, after the provider\nceiling. Omitted otherwise.","format":"int32","nullable":true},"warnings":{"type":"array","items":{"type":"string"},"description":"Warning codes of a row that connected, omitted when there are none: `daily_limit_clamped` (the row's\n`dailySendLimit` was above the mailbox's provider ceiling and was stored at the ceiling) or\n`settings_not_applied` (the mailbox connected, but its names or limit could not be saved).","nullable":true},"details":{"type":"array","items":{"$ref":"#/components/schemas/InboxImportRowDetail"},"description":"On a row that failed a column check, one entry per refused column, with `field` naming the column. Omitted\notherwise.","nullable":true}},"additionalProperties":false,"description":"One processed row of an inbox import."},"InboxImportRowDetail":{"type":"object","properties":{"field":{"type":"string","description":"The row column, such as `firstName` or `dailySendLimit`."},"code":{"type":"string","description":"Stable code for the problem, such as `invalid`."},"message":{"type":"string","description":"A sentence for people that says what is wrong with the column."}},"additionalProperties":false,"description":"One refused column of an inbox import row."},"InvalidationImpact":{"type":"object","properties":{"qualificationResponses":{"type":"integer","description":"Stored qualification answers the change would clear.","format":"int32"},"qualifiedFlags":{"type":"integer","description":"Contacts whose qualified result the change would clear.","format":"int32"},"segmentationReasoning":{"type":"integer","description":"Stored segmentation explanations the change would clear.","format":"int32"},"segmentationAssignmentsKept":{"type":"integer","description":"Contacts that keep their segment.","format":"int32"},"segmentationAssignmentsReset":{"type":"integer","description":"Contacts that go back to the default segment.","format":"int32"},"personalizationLines":{"type":"integer","description":"Personalized lines the change would clear.","format":"int32"},"personalizationLeads":{"type":"integer","description":"Contacts that would lose their personalized lines.","format":"int32"},"rewritingLines":{"type":"integer","description":"Rewritten lines the change would clear.","format":"int32"},"rewritingLeads":{"type":"integer","description":"Contacts that would lose their rewritten lines.","format":"int32"}},"additionalProperties":false,"description":"How much stored AI output a change would clear in each AI step of a campaign, and how many segment assignments it\nkeeps or resets."},"Job":{"type":"object","properties":{"id":{"type":"integer","description":"The job's id. Ids are unique only within one `type`, so send `type` with the id when you read or\ncancel the job.","format":"int64"},"type":{"type":"string","description":"The job type: `contact_import`, `contact_export`, `domain_health`, `lead_scoring`,\n`enrichment`, `crawl`, `extraction`, `batch_scrape`, `knowledge_export`,\n`inbox_import` or `migration`."},"status":{"type":"string","description":"One of `queued`, `running`, `succeeded`, `failed` or `canceled`. Only `crawl`,\n`extraction`, `batch_scrape` and `migration` jobs reach `canceled`, and a `contact_export`\nor `knowledge_export` is `succeeded` from the start."},"progress":{"allOf":[{"$ref":"#/components/schemas/JobProgress"}],"description":"How far the job has run."},"pollAfterSeconds":{"type":"integer","description":"While the job is `queued` or `running`, how many seconds to wait before reading it again: 10 for a\n`crawl`, `extraction` or `batch_scrape` (each read asks the scraping provider), 30 for a\n`migration`, and 5 for the other types. Omitted once the job has finished.","format":"int32","nullable":true},"resource":{"allOf":[{"$ref":"#/components/schemas/JobResource"}],"description":"The object the job belongs to, such as its campaign. Omitted when it has none."},"createdAt":{"type":"string","description":"When the job was created, in UTC.","format":"date-time"},"downloadUrl":{"type":"string","description":"The path that downloads the job's file, such as `/v1/contact-exports/{exportId}/content`. Only on a\n`contact_export` or `knowledge_export`, and omitted for other types.","nullable":true},"error":{"allOf":[{"$ref":"#/components/schemas/JobError"}],"description":"Why the job failed. Present only when `status` is `failed`."},"result":{"description":"The raw status and output of a `crawl`, `extraction` or `batch_scrape`, such as the scraped pages.\nReturned only by `GET /v1/jobs/{jobId}` for those types, and omitted for other types and in lists."},"domainsListed":{"type":"integer","description":"For a finished `domain_health` job: how many of the checked domains are on a blocklist. Omitted for other\ntypes and until the job finishes.","format":"int32","nullable":true},"excludedLibraryContacts":{"type":"integer","description":"For a `contact_export` of kind `contacts`, `campaign` or `advanced`: how many contacts from a\nKenso library list the export left out, since Kenso never exports them. Omitted for other kinds and types, or when\nKenso could not count them.","format":"int32","nullable":true},"inboxImport":{"allOf":[{"$ref":"#/components/schemas/InboxImportJob"}],"description":"Counts and row results of an `inbox_import`. Omitted for other types."},"personImport":{"allOf":[{"$ref":"#/components/schemas/PersonImportJob"}],"description":"Counts of a `contact_import` with target `people`. Omitted for an import into a campaign and for other\ntypes."},"skipped":{"allOf":[{"$ref":"#/components/schemas/ContactImportSkips"}],"description":"Rows a `contact_import` into a campaign skipped, by reason, with 0 for a reason that skipped none. Omitted\nfor an import with target `people` and for other types."}},"additionalProperties":false,"description":"A background job, such as a contact import, a contact export or a crawl."},"JobError":{"type":"object","properties":{"code":{"type":"string","description":"The reason code. It is `failed` for every job type except `inbox_import`, which uses\n`interrupted`, `feature_disabled` or `forbidden`."},"message":{"type":"string","description":"A readable description of what went wrong."}},"additionalProperties":false,"description":"Why a job failed."},"JobProgress":{"type":"object","properties":{"completed":{"type":"integer","description":"How many items the job has finished. The item depends on `type`: for example imported contacts for a\ncampaign `contact_import`, checked domains for `domain_health` and processed rows for `inbox_import`.","format":"int32"},"total":{"type":"integer","description":"How many items the job handles in all. Omitted when Kenso does not know the total, as for `domain_health`.","format":"int32","nullable":true}},"additionalProperties":false,"description":"How far a job has run."},"JobResource":{"type":"object","properties":{"type":{"type":"string","description":"The kind of object: `campaign` for a campaign `contact_import`, a `contact_export` of a campaign,\n`lead_scoring` and `enrichment`, or `migration_run` for a `migration`."},"id":{"type":"integer","description":"The object's id.","format":"int64"}},"additionalProperties":false,"description":"The object a job belongs to."},"JobResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Always true on a success."},"data":{"allOf":[{"$ref":"#/components/schemas/Job"}],"description":"The result of the operation."}},"additionalProperties":false,"description":"The body of a successful operation that returns one result. The result is in `data`."},"ListCheckBounce":{"type":"object","properties":{"expected":{"type":"number","description":"In percent, with the default choices: the fixes whose `defaultOn` is true applied, and the `contacted` rows\nskipped.","format":"double"},"beforeFixes":{"type":"number","description":"In percent, with no fix applied and the `contacted` rows kept.","format":"double"},"band":{"type":"string","description":"`green` when `expected` is under 2, `amber` from 2 to 5, and `red` over 5."}},"additionalProperties":false,"description":"The expected hard bounce rate of the rows added with an email."},"ListCheckBucket":{"type":"object","properties":{"key":{"type":"string","description":"The reason's key, as listed under `always`."},"label":{"type":"string","description":"The reason in words, for display, such as `Already in this campaign`."},"count":{"type":"integer","description":"The number of rows with this reason.","format":"int32"},"samples":{"type":"array","items":{"$ref":"#/components/schemas/ListCheckSample"},"description":"Up to 3 example rows."},"rows":{"type":"array","items":{"type":"integer","format":"int32"},"description":"The indexes of every row with this reason, counting from 0 into the `keys` lists."}},"additionalProperties":false,"description":"The rows the import skips for one reason."},"ListCheckContacted":{"type":"object","properties":{"count":{"type":"integer","description":"The number of those rows.","format":"int32"},"days":{"type":"integer","description":"The campaign's recently emailed window, in days. Null when the campaign has none, and then `count` is 0. Null\nfor a saved list.","format":"int32","nullable":true},"skipByDefault":{"type":"boolean","description":"True when the import skips these rows unless you send `includeRecentlyContacted=true`. False for a saved list."},"samples":{"type":"array","items":{"$ref":"#/components/schemas/ListCheckSample"},"description":"Up to 3 example rows."},"rows":{"type":"array","items":{"type":"integer","format":"int32"},"description":"The indexes of those rows, counting from 0 into the `keys` lists."}},"additionalProperties":false,"description":"The rows another campaign emailed within this campaign's recently emailed window."},"ListCheckItem":{"type":"object","properties":{"key":{"type":"string","description":"The fix key, as listed under `checks`. Send it in `fixes` to drop these rows."},"label":{"type":"string","description":"The check in words, for display, such as `Catch-all domain`."},"fixLabel":{"type":"string","description":"What the fix does, for display: `Drop`, `Skip` or `Keep 5 each`."},"count":{"type":"integer","description":"The number of rows the check marks.","format":"int32"},"defaultOn":{"type":"boolean","description":"True when the fix is on by default. `invalidEmail` and `noMx` are on by default, as are `blocklist`\nfor a saved list and `personalEmail` for a campaign that skips personal emails."},"prior":{"type":"number","description":"The expected hard bounce rate of the rows this check marks, from 0 to 1.","format":"double"},"note":{"type":"string","description":"One sentence about the check, for display, such as `No MX record on 2 domains.`"},"samples":{"type":"array","items":{"$ref":"#/components/schemas/ListCheckSample"},"description":"Up to 3 example rows."}},"additionalProperties":false,"description":"One optional fix: the rows a check marks, and whether the fix is on by default."},"ListCheckSample":{"type":"object","properties":{"row":{"type":"integer","description":"The row's number in the file, counting data rows from 1, header excluded. For `companyCap`, the company's first\nrow past the cap.","format":"int32"},"value":{"type":"string","description":"What identifies the row: its email, else its LinkedIn URL, else its company name or domain. For a saved list row with\nnone of those, the person's name. For `companyCap`, the company."},"reason":{"type":"string","description":"Why the row is here, in a few words, such as `same as row 4` or `acme.com has no MX`."}},"additionalProperties":false,"description":"One example row of a bucket or a check."},"ListCheckShare":{"type":"object","properties":{"label":{"type":"string","description":"The label, such as `VP` or `Google`."},"share":{"type":"integer","description":"The share, in whole percent.","format":"int32"}},"additionalProperties":false,"description":"One label's share of the rows."},"LoopsterImportRecordRequest":{"required":["id"],"type":"object","properties":{"id":{"type":"string","description":"The record's id in the search results. Required."},"position":{"type":"integer","description":"The record's `position` in the search results, 0 or more. Kenso uses it to find the record when it reads a\nmissing LinkedIn URL.","format":"int32","nullable":true},"fields":{"description":"The record's `fields` object, unchanged from the search results."}},"additionalProperties":false,"description":"One person picked in a provider tab of Search, as that search returned them."},"MeetingRepNotesCurrent":{"type":"object","properties":{"repNotes":{"type":"string","description":"Your notes as stored now. Empty before your first save."},"repNotesVersion":{"type":"integer","description":"The stored notes' version. Send it as `baseVersion` when you save again.","format":"int32"}},"additionalProperties":false,"description":"Your meeting notes as Kenso stores them now, sent with a `409 version_conflict` on a notes save."},"PersonImportJob":{"type":"object","properties":{"source":{"type":"string","description":"Where the rows came from, the import's `source`, such as `csv`, `search` or `google_sheets`."},"createdCount":{"type":"integer","description":"Rows that created a new person.","format":"int32"},"updatedCount":{"type":"integer","description":"Rows that matched a person already in the workspace and updated it. Kenso matches by email, LinkedIn URL, or\nname and company domain.","format":"int32"},"skippedCount":{"type":"integer","description":"Rows Kenso skipped: a row with no email, no LinkedIn URL and no name with a business company domain, or a row\nKenso could not take in.","format":"int32"},"startedAt":{"type":"string","description":"When the import started, in UTC. Omitted while it waits in the queue.","format":"date-time","nullable":true},"completedAt":{"type":"string","description":"When the import finished or failed, in UTC. Omitted until then.","format":"date-time","nullable":true}},"additionalProperties":false,"description":"Counts of a contact import with target `people`."},"RateLimitedText":{"type":"string","description":"The gateway's plain-text body of a `429` over the operation's own limit, until November 2026: `Number of requests exceeded. Please try again later.`","example":"Number of requests exceeded. Please try again later."},"Refusal":{"type":"object","properties":{"code":{"type":"string","description":"Stable refusal code in upper case, such as `CAMPAIGN_LIMIT_REACHED` or `INSUFFICIENT_CREDITS`."},"metric":{"type":"string","description":"What the limit counts: `Campaigns`, `Leads`, `Emails`, `LinkedInSeats` or `AiCredits`,\n`jobs_export_rows` or `funding_export_rows` for an export allowance, `credit_pack_credits`,\n`credit_spend_usd_7d`, `domains` or `mailboxes` for a limit on a new paying workspace, or for a\nKenso Lifetime cap its key: `workspaces`, `inboxes`, `contacts`, `email_verifications_day`,\n`email_verifications_month`, `people_results_day`, `company_results_day`,\n`funding_results_day`, `job_post_results_day`, `website_visits_month` or\n`visitor_lookups_day`. Omitted when a plan rule, not a count, refused the request.","nullable":true},"used":{"type":"integer","description":"How much of the limit is used, in the unit of `metric`. Omitted when the refusal has no count.","format":"int32","nullable":true},"limit":{"type":"integer","description":"The limit, in the unit of `metric`. Omitted when the refusal has no count.","format":"int32","nullable":true},"remaining":{"type":"integer","description":"How much of the limit is left, in the unit of `metric`. Omitted when the refusal has no count.","format":"int32","nullable":true},"planType":{"type":"string","description":"The workspace's plan as its snake plan id, for example `free`, `legacy_core` or `growth`."},"remedy":{"type":"string","description":"What lifts the refusal: `Upgrade`, `BuyAddOn`, `UpdatePaymentMethod` or `ContactSupport`.\n`None` means no action of yours lifts it."},"unlocksAt":{"type":"string","description":"When the limit lifts by itself, in UTC: for a limit on a new paying workspace once it has paid an invoice, and for\na Kenso Lifetime daily or monthly cap its reset (00:00 UTC, or the 1st of the month). Omitted on every other\nrefusal.","format":"date-time","nullable":true},"requiredMillicredits":{"type":"integer","description":"On a credit refusal, the millicredits the action needed. 1,000 millicredits are one credit. Omitted on every\nother refusal.","format":"int64","nullable":true},"availableMillicredits":{"type":"integer","description":"On a credit refusal, the millicredits available. On `FREE_CREDITS_NOT_ELIGIBLE`, only the credits that may\npay for inboxes and domains. Omitted on every other refusal.","format":"int64","nullable":true},"restrictedMillicredits":{"type":"integer","description":"On `FREE_CREDITS_NOT_ELIGIBLE`, the free and bonus millicredits in the balance that cannot pay for inboxes\nand domains. Omitted on every other refusal.","format":"int64","nullable":true},"feature":{"type":"string","description":"On `PLAN_FEATURE_NOT_AVAILABLE`, the plan feature the plan does not include, in snake case (for example\n`website_visitor_id`). Omitted on every other refusal.","nullable":true},"requiredPlan":{"type":"string","description":"On `PLAN_FEATURE_NOT_AVAILABLE`, the cheapest plan that includes `feature`, in snake case (for example\n`growth`). For a feature the self-serve trial locks (`browser_runs`), the trial's own plan,\nwhich paying for unlocks it. Omitted on every other refusal.","nullable":true},"requiredTier":{"type":"integer","description":"On a Kenso Lifetime refusal, the lowest tier that lifts it: the next tier with a higher cap, or the lowest tier\nthat includes `feature`. Omitted at the top tier, when no tier includes the feature, and on every other\nrefusal.","format":"int32","nullable":true},"upgradeUrl":{"type":"string","description":"On a Kenso Lifetime refusal that a higher tier lifts, the AppSumo page where the buyer upgrades their license.\nOmitted until Kenso has read that page from AppSumo, when no tier lifts the refusal, and on every other refusal.","nullable":true}},"additionalProperties":false,"description":"Why a plan rule or usage limit refused the request, and how to lift it."},"SearchContact":{"type":"object","properties":{"firstName":{"type":"string","description":"The person's first name. Kenso takes it from `fullName` when it is blank.","nullable":true},"lastName":{"type":"string","description":"The person's last name. Kenso takes it from `fullName` when it is blank.","nullable":true},"fullName":{"type":"string","description":"The person's full name. Kenso splits it when `firstName` or `lastName` is blank.","nullable":true},"title":{"type":"string","description":"The person's current job title.","nullable":true},"headline":{"type":"string","description":"The person's LinkedIn headline.","nullable":true},"location":{"type":"string","description":"Where the person is based, as free text.","nullable":true},"linkedInUrl":{"type":"string","description":"The person's LinkedIn profile URL.","nullable":true},"companyName":{"type":"string","description":"The name of the person's current company.","nullable":true},"companyDomain":{"type":"string","description":"The current company's website domain, such as `example.com`. Kenso reduces a full URL to its domain.","nullable":true},"companyLinkedInUrl":{"type":"string","description":"The current company's LinkedIn page URL.","nullable":true},"companyIndustry":{"type":"string","description":"The current company's industry.","nullable":true},"companyEmployeeCount":{"type":"integer","description":"The current company's number of employees.","format":"int32","nullable":true},"companyDescription":{"type":"string","description":"A description of the current company.","nullable":true},"companyType":{"type":"string","description":"The current company's type, as text.","nullable":true},"companyFoundedYear":{"type":"integer","description":"The year the current company was founded.","format":"int32","nullable":true},"companyLocation":{"type":"string","description":"The current company's location, as free text. Omitted, Kenso builds it from the headquarters city, state and\ncountry.","nullable":true},"companySpecialties":{"type":"string","description":"The current company's specialties, as one comma-separated string. Kenso also takes a JSON array of strings and\njoins it with commas.","nullable":true},"summary":{"type":"string","description":"The person's profile summary.","nullable":true},"experiencesJson":{"type":"string","description":"The person's work history, as a JSON array in a string. Kenso stores it as sent.","nullable":true},"educationJson":{"type":"string","description":"The person's education, as a JSON array in a string. Kenso stores it as sent.","nullable":true},"certificationsJson":{"type":"string","description":"The person's certifications, as a JSON array in a string. Kenso stores it as sent.","nullable":true},"inferredSkills":{"type":"string","description":"The person's skills, as one comma-separated string.","nullable":true},"languages":{"type":"string","description":"The languages the person speaks, as one comma-separated string. Kenso also takes a JSON array of strings and joins\nit with commas.","nullable":true},"lastJobDescription":{"type":"string","description":"The description of the person's current or latest job.","nullable":true},"kenCompanyId":{"type":"integer","description":"The current company's id in Kenso Search. Kenso uses it to fill in missing company data.","format":"int64","nullable":true},"profilePhotoUrl":{"type":"string","description":"The URL of the person's profile photo.","nullable":true},"city":{"type":"string","description":"The city where the person is based.","nullable":true},"state":{"type":"string","description":"The state or region where the person is based.","nullable":true},"country":{"type":"string","description":"The country where the person is based. Kenso leaves out a person in a country the campaign excludes.","nullable":true},"countryIso2":{"type":"string","description":"The two-letter ISO 3166 code of the person's country, such as `US`. Kenso leaves out a person in a country\nthe campaign excludes.","nullable":true},"seniorityLevel":{"type":"string","description":"The person's seniority, as text.","nullable":true},"function":{"type":"string","description":"The person's job function, as text.","nullable":true},"isDecisionMaker":{"type":"boolean","description":"Whether the person makes buying decisions. Default `false`."},"yearsOfExperience":{"type":"number","description":"The person's total years of work experience.","format":"float","nullable":true},"yearsInCurrentRole":{"type":"number","description":"The person's years in their current role.","format":"float","nullable":true},"yearsInCurrentCompany":{"type":"number","description":"The person's years at their current company.","format":"float","nullable":true},"changedJobRecently":{"type":"boolean","description":"Whether the person changed jobs recently. Default `false`."},"jobChangeDate":{"type":"string","description":"When the person changed jobs, as an ISO 8601 date and time.","format":"date-time","nullable":true},"companyFounded":{"type":"integer","description":"The year the current company was founded. Kenso reads it when `companyFoundedYear` is empty.","format":"int32","nullable":true},"headquartersCity":{"type":"string","description":"The city of the current company's headquarters.","nullable":true},"headquartersState":{"type":"string","description":"The state or region of the current company's headquarters.","nullable":true},"headquartersCountry":{"type":"string","description":"The country of the current company's headquarters.","nullable":true},"companySize":{"type":"string","description":"The current company's employee count range, as text.","nullable":true},"companyLogoUrl":{"type":"string","description":"The URL of the current company's logo.","nullable":true},"companyFollowers":{"type":"integer","description":"The current company's number of followers.","format":"int32","nullable":true},"companyTotalFunding":{"type":"integer","description":"The current company's total funding amount.","format":"int64","nullable":true},"companyLastFundingRoundType":{"type":"string","description":"The type of the current company's latest funding round, such as `Series A`.","nullable":true},"companyLastFundingAmount":{"type":"integer","description":"The amount the current company raised in its latest funding round, in US dollars. Kenso keeps it only with\n`companyLastFundingRoundType`.","format":"int64","nullable":true},"currentExperiences":{"type":"array","items":{"$ref":"#/components/schemas/CurrentExperienceImport"},"description":"The person's other current jobs, besides the main one. Kenso also looks at these companies when it searches for\nthe person's email.","nullable":true},"searchToken":{"type":"string","description":"Proof that Kenso Search found this person, set by Kenso on each person a people search, person lookup or buyer\npreview returns. Send it back unchanged with the person's `linkedInUrl`: a `source` `search` import\ncounts a person in your Free with Kenso savings only with a valid token, so a contact without one, or whose\nLinkedIn URL you changed, is still imported but not counted. Null on a contact Kenso did not find.","nullable":true}},"additionalProperties":false,"description":"One person to import, with their profile and current company."},"ServiceUnavailableError":{"oneOf":[{"$ref":"#/components/schemas/Failure"},{"$ref":"#/components/schemas/ApiKeyError"}],"description":"The body of a `503`: the error body (`Failure`). When Kenso cannot check the API key, its code is `auth_unavailable`, with `Retry-After: 5`. Until November 2026 the API key check in front of the operations answered `{ \"error\": \"Authentication is temporarily unavailable\" }` (`ApiKeyError`) there instead, so handle both shapes. Retry after the `Retry-After` seconds."},"TooManyRequestsError":{"oneOf":[{"$ref":"#/components/schemas/Failure"},{"$ref":"#/components/schemas/ApiKeyError"}],"description":"The JSON body of a `429`: the error body (`Failure`), with code `rate_limited` or `quota_exceeded`, over your workspace's rate limits, your API key's own limit, the operation's own limit or a usage quota. Until November 2026, over your API key's own limit the API key check answered `{ \"error\": \"Rate limit exceeded\" }` (`ApiKeyError`), and over the operation's own limit the gateway answered plain text (`RateLimitedText`): `Number of requests exceeded. Please try again later.` A client built against those answers keeps working: handle each shape. Wait the `Retry-After` seconds."},"UnauthorizedError":{"oneOf":[{"$ref":"#/components/schemas/Failure"},{"$ref":"#/components/schemas/ApiKeyError"}],"description":"The body of a `401`: the error body (`Failure`), whose `code` says what is wrong with the credential. Until November 2026, when the API key was not valid (unknown, expired or revoked, or its member no longer active), the API key check in front of the operations answered `{ \"error\": \"Invalid or revoked API key\" }` (`ApiKeyError`), and a request with no API key got a `401` that has no body. A client built against those answers keeps working: handle both shapes and a `401` with no body."}}}}