Skip to Content
Contacts and companies

Contact imports

Start a contact import and follow it as a job.

Contacts and companies3 endpointsKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe 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 date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy.
X-Ken-Workspace-Idheaderinteger (int64)optionalThe 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.

Start a contact import

POST/v1/contact-importscontact-imports.create
Permission
Campaigns edit and the import permission
Rate limit
480 requests a minute per API key

Try it on developer.ken.so

Adds people to a campaign from one source and answers 202 with a contact_import job. The import runs in the background, so poll GET /v1/jobs/{jobId}?type=contact_import until the job finishes. Every source runs the same checks: dedupe, the blocklist and the contact limits. For an import into a campaign, the job's skipped counts the rows Kenso left out, by reason.

Send a CSV file as multipart/form-data, and every other source as a JSON body with campaignId and source. Each source reads these fields:

  • csv: file, a CSV file of at most 400 MB and 100,000 rows, with the column names in row 1. columnMappings picks the contact field of each column. The form fields importLimit (a whole number above 0) and tagIds (a JSON array of 1 to 50 tag ids, such as [3,4]) work as for source search. Where the csv_import_check feature is on, fixes, includeRecentlyContacted and cleanup apply the choices of a scan.
  • campaign: sourceCampaignId, another campaign of the workspace. Kenso copies its contacts.
  • segment: sourceSegmentId, a segment of any campaign in the workspace. Kenso copies it into the campaign as a new segment with the same name.
  • search: contacts, 1 to 1,000 people found with Kenso Search. Each person of a buyer preview has such a row in its contact.
  • blitz: contacts, 1 to 1,000 rows of the same shape, for people picked in a provider tab of Search.
  • loopster: records, 1 to 1,000 people picked in a provider tab of Search, each as that search returned it, and the search's searchId.
  • people: personIds, 1 to 1,000 people of the workspace. Needs the accounts feature and Accounts view.
  • event: eventId, an outbound event. Its attendees with an email or a LinkedIn URL become contacts, at most 5,000. Needs the accounts and event_outbound features and Accounts view.
  • linkedin_connections: connectionIds, 1 to 1,000 of the workspace's LinkedIn connections. Needs the linkedin_network feature and Accounts view.
  • sales_navigator: linkedinAccountId, a LinkedIn account you connected, and url, a Sales Navigator lead search or lead list. One import reads at most 7 pages, about 175 to 350 people. A list Kenso cannot read to the end imports nothing and answers 400 validation_failed with code incomplete_read on url. Needs the sales_navigator feature.
  • linkedin_url: url, a LinkedIn post, people search, Sales Navigator search or Sales Navigator lead list. A LinkedIn account you connected reads it in the background. Needs the linkedin_url_import feature.
  • google_sheets: spreadsheetId and an optional sheet, read with your own Google connection. At most 100,000 rows, with the column names in row 1. Needs the google_sheets feature.
  • airtable: baseId, tableId and an optional viewId, read with the workspace's Airtable token. At most 10,000 records. Needs the airtable feature.
  • saved_list: savedListId, with optional memberFilters and roles. At most 100,000 contacts. Needs the saved_lists feature.

A source whose feature is off for you answers like an unknown source, with 400 validation_failed on source. Sources people, event and linkedin_url answer 404 not_found instead.

With target set to people, the rows become people of the workspace instead of campaign contacts, and Kenso ignores campaignId. This target takes the sources csv (send target as a form field), search, blitz, event, linkedin_connections, sales_navigator, google_sheets and airtable. Kenso matches each row to an existing person or creates one, with source import. A row needs an email, a LinkedIn URL, or a name with a business company domain. Kenso skips the other rows. The job's personImport counts the people created, updated and skipped. This target needs the lead_intake feature (404 not_found while it is off) and Accounts edit. A member who works only their own accounts cannot use it.

An option such as importLimit, tagIds or copyEmailEnrichment works only with the sources its field description names. Sent with another source, or with target people, it answers 400 validation_failed on that field. The segmentId field is not supported: sources search, blitz, loopster, segment and linkedin_connections refuse it, and the other sources ignore it.

A JSON body can be at most 10 MB. A multipart CSV upload can be at most 400 MB.

Errors:

  • 400 validation_failed: a required field is missing or out of range, source is unknown, an option does not fit the source, or no row can be imported. error.details names the field.
  • 400 unsupported_linkedin_url: source linkedin_url got a URL it cannot import.
  • 400 linkedin_account_required: source linkedin_url, and you have not connected a LinkedIn account.
  • 400 linkedin_account_unavailable: source linkedin_url, and the LinkedIn account is not one you connected, is not connected, or is paused.
  • 400 sales_navigator_required: source linkedin_url got a Sales Navigator URL, and the LinkedIn account has no Sales Navigator.
  • 402 plan_limit_reached: the import would pass the plan's contact or lead limit.
  • 402 trial_cap_reached: source search on the Growth trial, and the import would pass the trial's 1,000 Kenso database contacts in any 24 hours. error.refusal names the cap (daily_database_export_rows).
  • 403 permission_denied: you lack the Accounts access that the source or target people needs.
  • 404 not_found: campaignId or another id in the body was not found, or a feature that people, event, linkedin_url or target people needs is off.
  • 409 conflict: another import into the campaign is in progress, or source campaign already copied the same source campaign into it and allowReimport is not true.
  • 409 invalid_state: the LinkedIn account of source sales_navigator is not connected, or the Google file is not a Google Sheets spreadsheet.
  • 409 sales_navigator_required: source sales_navigator, and the LinkedIn account has no Sales Navigator.
  • 409 reconnect_required: source google_sheets, and your Google connection is missing or expired.
  • 409 sheet_not_shared: source google_sheets, and the sheet does not exist or was not picked for Kenso with Google Picker.
  • 409 not_connected: source airtable or loopster, and the workspace has no working connection to that service.
  • 409 scope_required: the Airtable token lacks the read scopes or access to the base.
  • 413 validation_failed: the JSON body is larger than 10 MB.
  • 429 rate_limited: the workspace used its daily import quota. Retry after the seconds in Retry-After. A CSV file of more than 100,000 rows gets the same answer: split the file.
  • 503 service_unavailable: Kenso could not start a campaign or segment copy right now, or could not reach Kenso Search for a saved list's roles. Nothing was imported, so retry.
  • 503 provider_unavailable: Google Sheets, Airtable or the provider behind a Search tab did not answer. Retry in a minute.

Requires Campaigns edit and the import permission.

Request body

application/json, required.

FieldTypeRequiredDescription
campaignIdinteger (int64)optionalThe campaign to import into. Required unless target is people, which ignores it.
sourcestringoptionalWhere the rows come from: campaign, segment, search, blitz, loopster, people, event, linkedin_connections, sales_navigator, linkedin_url, google_sheets, airtable or saved_list. A CSV file uses the multipart body instead.
targetstringoptionalWhat the import creates. With campaign (the default), the rows become contacts of campaignId. With people, they become people of the workspace instead, which needs the lead_intake feature and Accounts edit.
sourceCampaignIdinteger (int64)optionalSource campaign: the campaign of this workspace to copy contacts from. Required with that source, and it must differ from campaignId.
segmentIdinteger (int64)optionalNot supported. Sources search, blitz, loopster, segment and linkedin_connections answer 400 validation_failed when it is set, and the other sources ignore it.
contactsarray of SearchContactoptionalSource search or blitz: 1 to 1,000 people to add. For a campaign, a row needs a first and last name (or a fullName Kenso can split) and a company name, domain or LinkedIn URL, and Kenso skips the other rows.
searchIdstringoptionalSource loopster: the meta.searchId of the search the records came from, at most 200 characters. Required when a record has no LinkedIn URL: Kenso builds a temporary table from that search in the workspace's connected account to read the missing URLs, then moves the table to the trash.
recordsarray of LoopsterImportRecordRequestoptionalSource loopster: 1 to 1,000 people picked in a provider tab of Search, each as that search returned it.
personIdsarray of integer (int64)optionalSource people: 1 to 1,000 people of the workspace, each added with their name, email, title, LinkedIn URL and the company of their highest-priority account. Ids outside the workspace, or outside your own accounts when you work only those, are left out. A person who came from a Kenso library list answers 400 validation_failed with code library_origin: import their saved list instead.
eventIdinteger (int64)optionalSource event: the outbound event whose attendees become contacts. Kenso adds only attendees with an email or a LinkedIn URL, at most 5,000. A larger event answers 400 validation_failed on this field, so send roles to import one role at a time.
rolesarray of stringoptionalSource event: the attendee roles to import, from attendee, exhibitor, speaker and sponsor. Omitted imports every role. Source saved_list with a company list: up to 20 job titles of at most 100 characters each. Kenso Search then adds up to 5 people with those titles per company, for at most 500 companies, and a company where it finds nobody becomes one company contact.
includeAccountsbooleanoptionalSource event: true also adds attendees whose company is an account of the workspace. If you work only your own accounts, you get only the attendees on those. Default false.
connectionIdsarray of integer (int64)optionalSource linkedin_connections: 1 to 1,000 ids of the workspace's LinkedIn connections. Each becomes a contact with name, title, headline, LinkedIn URL, seniority, and the company's name, domain, LinkedIn URL, industry and size. Ids outside the workspace are left out.
linkedinAccountIdinteger (int64)optionalSource sales_navigator: the LinkedIn account that reads url, one you connected yourself with Sales Navigator. Required. Source linkedin_url: optional. Omitted, Kenso uses your first connected account that fits the URL.
urlstringoptionalSource sales_navigator: a Sales Navigator lead search or lead list URL. Source linkedin_url: a LinkedIn post, people search, Sales Navigator search or Sales Navigator lead list URL. At most 8,000 characters.
spreadsheetIdstringoptionalSource google_sheets: the spreadsheet id, or its Google Sheets URL. Required.
sheetstringoptionalSource google_sheets: the title of the sheet (tab) to read. Omitted reads the first sheet.
baseIdstringoptionalSource airtable: the Airtable base id, which starts with app. Required.
tableIdstringoptionalSource airtable: the table id (it starts with tbl) or name. Required. Its field names, primary field first, are the column names, and each record is one row of cell text.
viewIdstringoptionalSource airtable: a view id (it starts with viw) or name, to import only the view's records. Omitted reads the whole table. A table or view of more than 10,000 records answers 400 validation_failed on tableId, so import a large table in parts through views.
columnMappingsarray of CsvColumnMappingoptionalSource google_sheets or airtable: which column feeds which contact field, as for a CSV upload. Omitted, Kenso maps the columns by their names. Source saved_list refuses it: the list sets its own columns.
maxLeadsinteger (int32)optionalSource linkedin_url: the most people to import. From 1 to 2,000 for a post, to 1,000 for a people search and to 2,500 for a Sales Navigator URL. Default 500.
postKindsarray of stringoptionalSource linkedin_url with a post URL: whom to import, reaction, comment or both. Omitted imports both.
savedListIdinteger (int64)optionalSource saved_list: the list whose members Kenso imports. It can be a list of this workspace (a private list only for its owner), a list shared with the workspace, or a library list. Members this list already added to the campaign are skipped, so a retry adds only the rest. On a paid plan, an email a library list already verified as Safe arrives Safe with no email charge. A Free workspace gets no emails from a library list, and a member copied out of a library list follows the same rules in any list.
memberFiltersContactImportMemberFiltersBodyoptionalSource saved_list: narrows the members to import. More than 100,000 matching members answers 400 validation_failed on this field.
findPeoplebooleanoptionalSource saved_list: must be absent or false. To add people at the companies of a company list, send roles.
importLimitinteger (int32)optionalSource campaign or search: the most contacts to import, greater than 0. Omitted imports all.
importOffsetinteger (int32)optionalSource campaign: how many contacts of the source campaign to skip first, 0 or more.
onlyImportQualifiedContactsbooleanoptionalSource campaign: true copies only the contacts the source campaign qualified. Default false.
onlyImportValidContactsbooleanoptionalSource campaign: true copies only contacts with a valid email. Default false.
deduplicateCampaignIdsarray of integer (int64)optionalSource campaign: 1 to 50 other campaigns of the workspace. Kenso leaves out the people already in any of them. An id outside the workspace answers 404 not_found.
deduplicationModestringoptionalSource campaign: how Kenso spots a person who is already there. by_email (the default) compares email addresses, and by_data compares first name, last name and company. none turns the check off, so the copy can create duplicate contacts.
allowReimportbooleanoptionalSource campaign: true repeats a finished copy from the same source campaign. Without it, a repeat answers 409 conflict. Default false.
copyDataEnrichmentbooleanoptionalSource campaign: true keeps the source contacts' data enrichment, such as their LinkedIn profile and posts. Default false.
copyEmailEnrichmentbooleanoptionalSource campaign or segment: true keeps the emails Kenso already found for the source contacts. Default false.
triggerPostProcessingbooleanoptionalSource search: true (the default) starts enrichment and the AI steps after the import, and false skips them.
tagIdsarray of integer (int64)optionalSource search: 1 to 50 contact tags of the workspace to put on every imported contact.
sourceSegmentIdinteger (int64)optionalSource segment: the segment to copy, from any campaign of the workspace. Required. Kenso copies it into campaignId as a new segment with the same name, so a segment of that name already in the campaign answers 400 validation_failed.
copyQualificationbooleanoptionalSource segment: true keeps the source contacts' AI qualification results. Default false.
copyEmailVerificationbooleanoptionalSource segment: true keeps the source contacts' email verification results. Default false.
Request
curl -X POST "https://api.ken.so/v1/contact-imports" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "campaignId": 812,
  "source": "campaign",
  "target": "campaign",
  "sourceCampaignId": 812,
  "segmentId": 812,
  "contacts": [
    {
      "firstName": "Jane",
      "lastName": "Doe",
      "fullName": "Jane Doe",
      "title": "string",
      "headline": "string",
      "location": "string",
      "linkedInUrl": "https://example.com",
      "companyName": "Acme",
      "companyDomain": "example.com",
      "companyLinkedInUrl": "https://example.com",
      "companyIndustry": "string",
      "companyEmployeeCount": 1,
      "companyDescription": "string",
      "companyType": "string",
      "companyFoundedYear": 1,
      "companyLocation": "string",
      "companySpecialties": "string",
      "summary": "string",
      "experiencesJson": "string",
      "educationJson": "string",
      "certificationsJson": "string",
      "inferredSkills": "string",
      "languages": "string",
      "lastJobDescription": "string",
      "kenCompanyId": 812,
      "profilePhotoUrl": "https://example.com",
      "city": "string",
      "state": "string",
      "country": "string",
      "countryIso2": "US",
      "seniorityLevel": "string",
      "function": "string",
      "isDecisionMaker": true,
      "yearsOfExperience": 0.5,
      "yearsInCurrentRole": 0.5,
      "yearsInCurrentCompany": 0.5,
      "changedJobRecently": true,
      "jobChangeDate": "2026-09-23T15:02:11Z",
      "companyFounded": 1,
      "headquartersCity": "string",
      "headquartersState": "string",
      "headquartersCountry": "string",
      "companySize": "string",
      "companyLogoUrl": "https://example.com",
      "companyFollowers": 1,
      "companyTotalFunding": 1,
      "companyLastFundingRoundType": "string",
      "companyLastFundingAmount": 1,
      "currentExperiences": [
        {
          "companyId": 812,
          "companyName": "Acme",
          "companyUrl": "https://example.com",
          "companyDomain": "example.com",
          "companyEmployeeCount": 1,
          "title": "string",
          "startDate": "2026-09-23T15:02:11Z"
        }
      ],
      "searchToken": "string"
    }
  ],
  "searchId": "string",
  "records": [
    {
      "id": "string",
      "position": 1,
      "fields": null
    }
  ],
  "personIds": [
    812
  ],
  "eventId": 812,
  "roles": [
    "string"
  ],
  "includeAccounts": true,
  "connectionIds": [
    812
  ],
  "linkedinAccountId": 812,
  "url": "https://example.com",
  "spreadsheetId": "string",
  "sheet": "string",
  "baseId": "app2bX9kq4LmR7tW3vY",
  "tableId": "tbl2bX9kq4LmR7tW3vY",
  "viewId": "viw2bX9kq4LmR7tW3vY",
  "columnMappings": [
    {
      "csvColumn": "string",
      "targetField": "email",
      "customVariableName": "string",
      "useAsAiContext": true,
      "isRequiredForSending": true
    }
  ],
  "maxLeads": 1,
  "postKinds": [
    "string"
  ],
  "savedListId": 812,
  "memberFilters": {
    "country": "string",
    "seniority": "string",
    "title": "string",
    "industry": "string",
    "headcountBand": "string",
    "hasSendableEmail": true
  },
  "findPeople": true,
  "importLimit": 1,
  "importOffset": 1,
  "onlyImportQualifiedContacts": true,
  "onlyImportValidContacts": true,
  "deduplicateCampaignIds": [
    812
  ],
  "deduplicationMode": "by_email",
  "allowReimport": true,
  "copyDataEnrichment": true,
  "copyEmailEnrichment": true,
  "triggerPostProcessing": true,
  "tagIds": [
    812
  ],
  "sourceSegmentId": 812,
  "copyQualification": true,
  "copyEmailVerification": true
}'

Response 202

data is a Job.

Show the 14 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Preview buyers at a list of companies

POST/v1/contact-imports/buyer-previewscontact-imports.buyer-preview
Permission
Campaigns edit and the import permission
Rate limit
240 requests a minute per API key
Needs the csv_buyer_preview feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

Finds the people to contact at each company of a list, matched to a campaign's ideal customer profile (ICP). Use it when a file lists companies instead of people: preview the people, drop the ones you do not want, then add the rest with POST /v1/contact-imports.

The body needs campaignId and companies: from 1 to 50 companies, each with a name, a domain or both, and an optional key that the answer echoes back. Send a longer list in parts of 50. perCompany sets how many people to return per company, from 1 to 3 (default 3). Example body: { "campaignId": 812, "companies": [{ "key": "row-2", "name": "Northwind", "domain": "northwind.com" }], "perCompany": 3 }.

Kenso looks up each company in Kenso Search. A company sent with a domain matches the company that owns the domain: the one with the same name at that domain, else the one whose website is the domain's home page. A company that only has a page under the domain (such as notion.so/acme) does not own it, and Kenso never matches by name in its place. A company sent without a domain matches when exactly one company in Kenso Search has its name.

The ICP is the people filters of the campaign's active segments: titles, seniority levels, functions, decision makers and exclusions. For each matched company, Kenso lists up to perCompany people in the ICP, best first. When the ICP finds too few, Kenso fills the company from a looser search and marks those people weakMatch. When the campaign has no ICP, Kenso ranks people by seniority. Each person appears once in the whole answer, even when Kenso Search holds them twice.

Each kept person's contact goes unchanged into the contacts of a POST /v1/contact-imports call with source search. Deduplication, the blocklist and lead credits apply there. The preview stores nothing and charges nothing. It counts the companies times perCompany against the workspace's daily searchBrowseRows quota, the same quota Search results use. A company Kenso Search does not answer for in time comes back failed: send it again.

Errors:

  • 400 validation_failed: campaignId is missing, companies is empty or holds more than 50, a company has neither a name nor a domain (the error names companies[i]), or perCompany is less than 1 or more than 3.
  • 404 not_found: the campaign is not in the workspace.
  • 429 quota_exceeded: the request would pass the workspace's searchBrowseRows quota. Wait for the Retry-After seconds.

Requires Campaigns edit and the import permission.

Request body

application/json, optional.

FieldTypeRequiredDescription
campaignIdinteger (int64)requiredThe campaign whose ideal customer profile the people are matched to. Required.
companiesarray of BuyerPreviewCompanyInputoptionalThe companies to search, from 1 to 50. Each needs a name, a domain or both.
perCompanyinteger (int32)optionalThe most people to return per company, from 1 to 3. Omitted means 3.
Request
curl -X POST "https://api.ken.so/v1/contact-imports/buyer-previews" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "campaignId": 812,
  "companies": [
    {
      "key": "string",
      "name": "string",
      "domain": "northwind.com"
    }
  ],
  "perCompany": 1
}'

Response 200

data is a BuyerPreview.

Show the 2 response fields and an example

The fields and an example are also on this endpoint's Markdown page.

Scan an import file

POST/v1/contact-imports/scanscontact-imports.scan
Permission
Campaigns view and the import permission
Rate limit
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)
Needs the csv_import_check feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

Suggests the contact field for each column of an import file, from its header row and a few sample rows. Send keys as well to run the list check: it reads every row and reports the rows the import skips anyway and the risky rows you can drop. Call it before you import a CSV file, a Google Sheet or an Airtable table with POST /v1/contact-imports, or before you upload a file to a saved list.

The body needs source (csv, google_sheets or airtable), headers (from 1 to 200 column names, each at most 500 characters) and up to 200 sampleRows (each cell at most 2,000 characters). target says where the rows go:

  • campaign (the default) needs campaignId.
  • people suggests only the fields a people import stores and runs no list check.
  • saved_list needs savedListId for an existing list or savedListKind for a list you have not created yet, never both. It also needs Search view and the saved_lists feature on the workspace.

The list check runs for campaign and saved_list when you send keys: the key columns of every row, one list per column, all of the same length from 1 to 25,000. keys.rowCount is the file's row count and must be at least that length. For a larger file, send its first 25,000 rows and the full row count. The check then says truncated. A scan that sends keys skips the AI suggestions. To get both, scan once without keys to map the columns, then again with keys filled from the mapped columns. Example body: { "source": "csv", "campaignId": 42, "headers": ["Full Name", "Work contact"], "sampleRows": [["Ada Lovelace", "[email protected]"]], "keys": { "rowCount": 1, "fullName": ["Ada Lovelace"], "email": ["[email protected]"] } }.

Pass the answer on to the import. Each column's csvColumn, targetField and customVariableName are the fields of a columnMappings entry of POST /v1/contact-imports. For a campaign, send the keys of the checks you keep on in the import's fixes form field (a JSON array), send includeRecentlyContacted=true to keep the rows in contacted, and send cleanup with the value of cleanupApplied. The import applies none of them unless you send them. For a saved list, send fixes and cleanup the same way to POST /v1/saved-lists/{savedListId}/uploads.

The scan stores nothing and charges nothing. The list check reads only data Kenso already has and runs no paid lookup. Each call counts against the workspace's contactImportScans quota: 30 a minute, 600 an hour and 5,000 a day.

Errors:

  • 400 validation_failed: a body field breaks a rule above. The error names the field.
  • 403 permission_denied: target is saved_list and the caller lacks Search view.
  • 404 not_found: the campaign is not in the workspace, the saved list is not one of the workspace's own lists (a list shared from elsewhere, a library list or another member's private list), or target is saved_list while the saved_lists feature is off.
  • 429 quota_exceeded: the workspace used up its scans for now. Wait for the Retry-After seconds.

Requires Campaigns view and the import permission.

Request body

application/json, optional.

FieldTypeRequiredDescription
sourcestringrequiredWhere the file comes from: csv, google_sheets or airtable. Required.
targetstringoptionalWhere the rows go: campaign, people (workspace people, only the fields a people import stores) or saved_list. Omitted means campaign.
campaignIdinteger (int64)optionalThe campaign the file goes into. Required when target is campaign.
savedListIdinteger (int64)optionalThe saved list the file goes into, when target is saved_list. It must be one of the workspace's own lists that the caller can see. Send this or savedListKind, not both.
savedListKindstringoptionalThe kind of a saved list you have not created yet: people or companies. Send it instead of savedListId when target is saved_list. Kenso reads the rows as a new list of that kind would.
headersarray of stringoptionalThe file's header row: from 1 to 200 column names, each at most 500 characters.
sampleRowsarray of array of stringoptionalUp to 200 data rows, each a list of cells in header order. Each cell is at most 2,000 characters. Kenso reads a missing cell at the end of a short row as blank and ignores cells past the last header.
keysContactImportScanKeysoptionalThe key columns of every row, for the list check. Kenso runs the check when target is campaign or saved_list. Sending it skips the AI suggestions.
Request
curl -X POST "https://api.ken.so/v1/contact-imports/scans" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "source": "csv",
  "target": "string",
  "campaignId": 812,
  "savedListId": 812,
  "savedListKind": "people",
  "headers": [
    "string"
  ],
  "sampleRows": [
    [
      "string"
    ]
  ],
  "keys": {
    "rowCount": 1,
    "cleanup": true,
    "email": [
      "[email protected]"
    ],
    "profileUrl": [
      "https://example.com"
    ],
    "companyDomain": [
      "example.com"
    ],
    "companyName": [
      "Acme"
    ],
    "companyLinkedinUrl": [
      "https://example.com"
    ],
    "firstName": [
      "Jane"
    ],
    "lastName": [
      "Doe"
    ],
    "fullName": [
      "Jane Doe"
    ],
    "title": [
      "string"
    ],
    "emailValidity": [
      "string"
    ],
    "otherEmails": [
      [
        "[email protected]"
      ]
    ],
    "otherEmailValidity": [
      [
        "string"
      ]
    ]
  }
}'

Response 200

data is a ContactImportScan.

Show the 3 response fields and an example

The fields and an example are also on this endpoint's Markdown page.


On this page