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

# Contact imports: Start a contact import

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

One endpoint of [Contact imports](/docs/api/contact-imports.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Start a contact import

`POST /v1/contact-imports` - operationId `contact-imports.create`

| Permission | Rate limit |
| --- | --- |
| Campaigns edit and the `import` permission | 480 requests a minute per API key |

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. On Kenso Lifetime,
`error.refusal` carries the code `LIFETIME_CONTACT_LIMIT_REACHED` when the import would pass the
license's contacts (one pool across its workspaces), or, for source `search`,
`LIFETIME_PEOPLE_RESULT_LIMIT_REACHED` when it would pass the license's people results for the day, which
reset at 00:00 UTC.
- `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.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/contact-imports/POST/v1/contact-imports)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | 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. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | 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`. |

### Request body

`application/json`, required.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `campaignId` | integer (int64) | no | The campaign to import into. Required unless `target` is `people`, which ignores it. |
| `source` | string | no | Where 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. |
| `target` | string | no | What 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. |
| `sourceCampaignId` | integer (int64) | no | Source `campaign`: the campaign of this workspace to copy contacts from. Required with that source, and it must differ from `campaignId`. |
| `segmentId` | integer (int64) | no | Not supported. Sources `search`, `blitz`, `loopster`, `segment` and `linkedin_connections` answer `400 validation_failed` when it is set, and the other sources ignore it. |
| `contacts` | array of SearchContact | no | Source `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. |
| `searchId` | string | no | Source `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. |
| `records` | array of LoopsterImportRecordRequest | no | Source `loopster`: 1 to 1,000 people picked in a provider tab of Search, each as that search returned it. |
| `personIds` | array of integer (int64) | no | Source `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. |
| `eventId` | integer (int64) | no | Source `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. |
| `roles` | array of string | no | Source `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. |
| `includeAccounts` | boolean | no | Source `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`. |
| `connectionIds` | array of integer (int64) | no | Source `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. |
| `linkedinAccountId` | integer (int64) | no | Source `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. |
| `url` | string | no | Source `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. |
| `spreadsheetId` | string | no | Source `google_sheets`: the spreadsheet id, or its Google Sheets URL. Required. |
| `sheet` | string | no | Source `google_sheets`: the title of the sheet (tab) to read. Omitted reads the first sheet. |
| `baseId` | string | no | Source `airtable`: the Airtable base id, which starts with `app`. Required. |
| `tableId` | string | no | Source `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. |
| `viewId` | string | no | Source `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. |
| `columnMappings` | array of CsvColumnMapping | no | Source `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. |
| `maxLeads` | integer (int32) | no | Source `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. |
| `postKinds` | array of string | no | Source `linkedin_url` with a post URL: whom to import, `reaction`, `comment` or both. Omitted imports both. |
| `savedListId` | integer (int64) | no | Source `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. |
| `memberFilters` | ContactImportMemberFiltersBody | no | Source `saved_list`: narrows the members to import. More than 100,000 matching members answers `400 validation_failed` on this field. |
| `findPeople` | boolean | no | Source `saved_list`: must be absent or `false`. To add people at the companies of a company list, send `roles`. |
| `importLimit` | integer (int32) | no | Source `campaign` or `search`: the most contacts to import, greater than 0. Omitted imports all. |
| `importOffset` | integer (int32) | no | Source `campaign`: how many contacts of the source campaign to skip first, 0 or more. |
| `onlyImportQualifiedContacts` | boolean | no | Source `campaign`: `true` copies only the contacts the source campaign qualified. Default `false`. |
| `onlyImportValidContacts` | boolean | no | Source `campaign`: `true` copies only contacts with a valid email. Default `false`. |
| `deduplicateCampaignIds` | array of integer (int64) | no | Source `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`. |
| `deduplicationMode` | string | no | Source `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. |
| `allowReimport` | boolean | no | Source `campaign`: `true` repeats a finished copy from the same source campaign. Without it, a repeat answers `409 conflict`. Default `false`. |
| `copyDataEnrichment` | boolean | no | Source `campaign`: `true` keeps the source contacts' data enrichment, such as their LinkedIn profile and posts. Default `false`. |
| `copyEmailEnrichment` | boolean | no | Source `campaign` or `segment`: `true` keeps the emails Kenso already found for the source contacts. Default `false`. |
| `triggerPostProcessing` | boolean | no | Source `search`: `true` (the default) starts enrichment and the AI steps after the import, and `false` skips them. |
| `tagIds` | array of integer (int64) | no | Source `search`: 1 to 50 contact tags of the workspace to put on every imported contact. |
| `sourceSegmentId` | integer (int64) | no | Source `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`. |
| `copyQualification` | boolean | no | Source `segment`: `true` keeps the source contacts' AI qualification results. Default `false`. |
| `copyEmailVerification` | boolean | no | Source `segment`: `true` keeps the source contacts' email verification results. Default `false`. |

### Response 202

`data` is a `Job`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer (int64) | The job's id. Ids are unique only within one `type`, so send `type` with the id when you read or cancel the job. |
| `type` | string | The job type: `contact_import`, `contact_export`, `domain_health`, `lead_scoring`, `enrichment`, `crawl`, `extraction`, `batch_scrape`, `knowledge_export`, `inbox_import` or `migration`. |
| `status` | string | One of `queued`, `running`, `succeeded`, `failed` or `canceled`. Only `crawl`, `extraction`, `batch_scrape` and `migration` jobs reach `canceled`, and a `contact_export` or `knowledge_export` is `succeeded` from the start. |
| `progress` | JobProgress | How far the job has run. |
| `pollAfterSeconds` | integer (int32) | While the job is `queued` or `running`, how many seconds to wait before reading it again: 10 for a `crawl`, `extraction` or `batch_scrape` (each read asks the scraping provider), 30 for a `migration`, and 5 for the other types. Omitted once the job has finished. |
| `resource` | JobResource | The object the job belongs to, such as its campaign. Omitted when it has none. |
| `createdAt` | string (date-time) | When the job was created, in UTC. |
| `downloadUrl` | string | The path that downloads the job's file, such as `/v1/contact-exports/{exportId}/content`. Only on a `contact_export` or `knowledge_export`, and omitted for other types. |
| `error` | JobError | Why the job failed. Present only when `status` is `failed`. |
| `result` | object | The raw status and output of a `crawl`, `extraction` or `batch_scrape`, such as the scraped pages. Returned only by `GET /v1/jobs/{jobId}` for those types, and omitted for other types and in lists. |
| `domainsListed` | integer (int32) | For a finished `domain_health` job: how many of the checked domains are on a blocklist. Omitted for other types and until the job finishes. |
| `excludedLibraryContacts` | integer (int32) | For a `contact_export` of kind `contacts`, `campaign` or `advanced`: how many contacts from a Kenso library list the export left out, since Kenso never exports them. Omitted for other kinds and types, or when Kenso could not count them. |
| `inboxImport` | InboxImportJob | Counts and row results of an `inbox_import`. Omitted for other types. |
| `personImport` | PersonImportJob | Counts of a `contact_import` with target `people`. Omitted for an import into a campaign and for other types. |
| `skipped` | ContactImportSkips | Rows a `contact_import` into a campaign skipped, by reason, with 0 for a reason that skipped none. Omitted for an import with target `people` and for other types. |

### Request

```bash
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
}'
```

### Example response

```json
{
  "success": true,
  "data": {
    "id": 812,
    "type": "contact_import",
    "status": "queued",
    "progress": {
      "completed": 1,
      "total": 1
    },
    "pollAfterSeconds": 1,
    "resource": {
      "type": "string",
      "id": 812
    },
    "createdAt": "2026-09-23T15:02:11Z",
    "downloadUrl": "/v1/contact-exports/{exportId}/content",
    "error": {
      "code": "string",
      "message": "string"
    },
    "result": null,
    "domainsListed": 1,
    "excludedLibraryContacts": 1,
    "inboxImport": {
      "connectedCount": 1,
      "failedCount": 1,
      "skippedCount": 1,
      "startedAt": "2026-09-23T15:02:11Z",
      "updatedAt": "2026-09-23T15:02:11Z",
      "completedAt": "2026-09-23T15:02:11Z",
      "rows": [
        {
          "index": 1,
          "email": "jane@example.com",
          "status": "connected",
          "inboxId": 812,
          "errorCode": "string",
          "message": "string",
          "firstName": "Jane",
          "lastName": "Doe",
          "dailySendLimit": 1,
          "warnings": [
            "string"
          ],
          "details": [
            {}
          ]
        }
      ]
    },
    "personImport": {
      "source": "csv",
      "createdCount": 1,
      "updatedCount": 1,
      "skippedCount": 1,
      "startedAt": "2026-09-23T15:02:11Z",
      "completedAt": "2026-09-23T15:02:11Z"
    },
    "skipped": {
      "duplicateInCampaign": 1,
      "duplicateInOtherCampaign": 1,
      "duplicateInSource": 1,
      "alreadyContacted": 1,
      "blocklist": 1,
      "failedValidation": 1,
      "salesNavigatorProfileUnresolved": 1,
      "other": 1,
      "missingKey": 1,
      "invalidEmail": 1,
      "noMx": 1,
      "catchAll": 1,
      "personalEmail": 1,
      "roleAddress": 1,
      "companyContacted": 1,
      "companyCap": 1
    }
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### SearchContact

One person to import, with their profile and current company.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `firstName` | string | no | The person's first name. Kenso takes it from `fullName` when it is blank. |
| `lastName` | string | no | The person's last name. Kenso takes it from `fullName` when it is blank. |
| `fullName` | string | no | The person's full name. Kenso splits it when `firstName` or `lastName` is blank. |
| `title` | string | no | The person's current job title. |
| `headline` | string | no | The person's LinkedIn headline. |
| `location` | string | no | Where the person is based, as free text. |
| `linkedInUrl` | string | no | The person's LinkedIn profile URL. |
| `companyName` | string | no | The name of the person's current company. |
| `companyDomain` | string | no | The current company's website domain, such as `example.com`. Kenso reduces a full URL to its domain. |
| `companyLinkedInUrl` | string | no | The current company's LinkedIn page URL. |
| `companyIndustry` | string | no | The current company's industry. |
| `companyEmployeeCount` | integer (int32) | no | The current company's number of employees. |
| `companyDescription` | string | no | A description of the current company. |
| `companyType` | string | no | The current company's type, as text. |
| `companyFoundedYear` | integer (int32) | no | The year the current company was founded. |
| `companyLocation` | string | no | The current company's location, as free text. Omitted, Kenso builds it from the headquarters city, state and country. |
| `companySpecialties` | string | no | The current company's specialties, as one comma-separated string. Kenso also takes a JSON array of strings and joins it with commas. |
| `summary` | string | no | The person's profile summary. |
| `experiencesJson` | string | no | The person's work history, as a JSON array in a string. Kenso stores it as sent. |
| `educationJson` | string | no | The person's education, as a JSON array in a string. Kenso stores it as sent. |
| `certificationsJson` | string | no | The person's certifications, as a JSON array in a string. Kenso stores it as sent. |
| `inferredSkills` | string | no | The person's skills, as one comma-separated string. |
| `languages` | string | no | The languages the person speaks, as one comma-separated string. Kenso also takes a JSON array of strings and joins it with commas. |
| `lastJobDescription` | string | no | The description of the person's current or latest job. |
| `kenCompanyId` | integer (int64) | no | The current company's id in Kenso Search. Kenso uses it to fill in missing company data. |
| `profilePhotoUrl` | string | no | The URL of the person's profile photo. |
| `city` | string | no | The city where the person is based. |
| `state` | string | no | The state or region where the person is based. |
| `country` | string | no | The country where the person is based. Kenso leaves out a person in a country the campaign excludes. |
| `countryIso2` | string | no | The two-letter ISO 3166 code of the person's country, such as `US`. Kenso leaves out a person in a country the campaign excludes. |
| `seniorityLevel` | string | no | The person's seniority, as text. |
| `function` | string | no | The person's job function, as text. |
| `isDecisionMaker` | boolean | no | Whether the person makes buying decisions. Default `false`. |
| `yearsOfExperience` | number (float) | no | The person's total years of work experience. |
| `yearsInCurrentRole` | number (float) | no | The person's years in their current role. |
| `yearsInCurrentCompany` | number (float) | no | The person's years at their current company. |
| `changedJobRecently` | boolean | no | Whether the person changed jobs recently. Default `false`. |
| `jobChangeDate` | string (date-time) | no | When the person changed jobs, as an ISO 8601 date and time. |
| `companyFounded` | integer (int32) | no | The year the current company was founded. Kenso reads it when `companyFoundedYear` is empty. |
| `headquartersCity` | string | no | The city of the current company's headquarters. |
| `headquartersState` | string | no | The state or region of the current company's headquarters. |
| `headquartersCountry` | string | no | The country of the current company's headquarters. |
| `companySize` | string | no | The current company's employee count range, as text. |
| `companyLogoUrl` | string | no | The URL of the current company's logo. |
| `companyFollowers` | integer (int32) | no | The current company's number of followers. |
| `companyTotalFunding` | integer (int64) | no | The current company's total funding amount. |
| `companyLastFundingRoundType` | string | no | The type of the current company's latest funding round, such as `Series A`. |
| `companyLastFundingAmount` | integer (int64) | no | The amount the current company raised in its latest funding round, in US dollars. Kenso keeps it only with `companyLastFundingRoundType`. |
| `currentExperiences` | array of CurrentExperienceImport | no | The person's other current jobs, besides the main one. Kenso also looks at these companies when it searches for the person's email. |
| `searchToken` | string | no | Proof that Kenso Search found this person, set by Kenso on each person a people search, person lookup or buyer preview returns. Send it back unchanged with the person's `linkedInUrl`: a `source` `search` import counts a person in your Free with Kenso savings only with a valid token, so a contact without one, or whose LinkedIn URL you changed, is still imported but not counted. Null on a contact Kenso did not find. |

### LoopsterImportRecordRequest

One person picked in a provider tab of Search, as that search returned them.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | yes | The record's id in the search results. Required. |
| `position` | integer (int32) | no | The record's `position` in the search results, 0 or more. Kenso uses it to find the record when it reads a missing LinkedIn URL. |
| `fields` | object | no | The record's `fields` object, unchanged from the search results. |

### CsvColumnMapping

Which column of the file feeds which contact field.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `csvColumn` | string | no | The column's name as row 1 of the file has it. Kenso compares names trimmed and ignoring case. |
| `targetField` | string | no | The contact field the column feeds, as an import key such as `email`, `first_name`, `full_name`, `title`, `profile_url` (the LinkedIn URL), `company_name` or `company_domain`. Send `custom_variable` to keep the column as a custom variable. A scan suggests the key for each column. |
| `customVariableName` | string | no | With `targetField` `custom_variable`: the custom variable's name. Required for that target. |
| `useAsAiContext` | boolean | no | With `targetField` `custom_variable`: `true` lets the AI steps use the value as context. Omitted, a new variable starts as `true` and an existing one keeps its setting. |
| `isRequiredForSending` | boolean | no | With `targetField` `custom_variable`: `true` holds a contact back from sending until the variable has a value. Omitted, a new variable starts as `false` and an existing one keeps its setting. |

### ContactImportMemberFiltersBody

Filters that narrow the members of a saved list to import. A null or empty field does not filter.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | no | Keeps members in this country, matched exactly. At most 200 characters. |
| `seniority` | string | no | Keeps members with this seniority, matched exactly. At most 200 characters. |
| `title` | string | no | Keeps members whose job title contains this text, ignoring case. At most 200 characters. |
| `industry` | string | no | Keeps members in this industry, matched exactly. At most 200 characters. |
| `headcountBand` | string | no | Keeps members whose company is in this headcount band, matched exactly. At most 200 characters. |
| `hasSendableEmail` | boolean | no | When `true`, keeps only members with a sendable email. When `false`, keeps only those without one. |

### CurrentExperienceImport

Another job the person holds now, besides the main one.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `companyId` | integer (int64) | no | Not read by the import. |
| `companyName` | string | no | The company's name. Kenso ignores an entry with neither a name nor a domain. |
| `companyUrl` | string | no | The company's LinkedIn page URL. |
| `companyDomain` | string | no | The company's website domain, such as `example.com`. |
| `companyEmployeeCount` | integer (int32) | no | The company's number of employees. |
| `title` | string | no | The person's job title at this company. |
| `startDate` | string (date-time) | no | When the person started this job, as an ISO 8601 date and time. |

### JobProgress

How far a job has run.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `completed` | integer (int32) | no | How many items the job has finished. The item depends on `type`: for example imported contacts for a campaign `contact_import`, checked domains for `domain_health` and processed rows for `inbox_import`. |
| `total` | integer (int32) | no | How many items the job handles in all. Omitted when Kenso does not know the total, as for `domain_health`. |

### JobResource

The object a job belongs to.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | no | The kind of object: `campaign` for a campaign `contact_import`, a `contact_export` of a campaign, `lead_scoring` and `enrichment`, or `migration_run` for a `migration`. |
| `id` | integer (int64) | no | The object's id. |

### JobError

Why a job failed.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `code` | string | no | The reason code. It is `failed` for every job type except `inbox_import`, which uses `interrupted`, `feature_disabled` or `forbidden`. |
| `message` | string | no | A readable description of what went wrong. |

### InboxImportJob

Counts and row results of an inbox import, without any passwords.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `connectedCount` | integer (int32) | no | Rows that connected an inbox. |
| `failedCount` | integer (int32) | no | Rows that failed to connect. |
| `skippedCount` | integer (int32) | no | Rows Kenso skipped, such as an inbox the workspace already has. |
| `startedAt` | string (date-time) | no | When the import started on its first row, in UTC. Omitted while it waits in the queue. |
| `updatedAt` | string (date-time) | no | When the import last made progress, in UTC. An import with no progress for 10 minutes reads `failed` with `error.code` `interrupted`. |
| `completedAt` | string (date-time) | no | When the import finished, in UTC. Omitted until it finishes. |
| `rows` | array of InboxImportRow | no | Processed rows in `index` order, empty until the first row has a result. Returned when you create or get the import, and omitted in lists and for a member without Delivery view. |

### PersonImportJob

Counts of a contact import with target `people`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `source` | string | no | Where the rows came from, the import's `source`, such as `csv`, `search` or `google_sheets`. |
| `createdCount` | integer (int32) | no | Rows that created a new person. |
| `updatedCount` | integer (int32) | no | Rows that matched a person already in the workspace and updated it. Kenso matches by email, LinkedIn URL, or name and company domain. |
| `skippedCount` | integer (int32) | no | Rows Kenso skipped: a row with no email, no LinkedIn URL and no name with a business company domain, or a row Kenso could not take in. |
| `startedAt` | string (date-time) | no | When the import started, in UTC. Omitted while it waits in the queue. |
| `completedAt` | string (date-time) | no | When the import finished or failed, in UTC. Omitted until then. |

### ContactImportSkips

Rows a campaign contact import skipped, with each row counted under one reason.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `duplicateInCampaign` | integer (int32) | no | Rows that match a contact already in this campaign. |
| `duplicateInOtherCampaign` | integer (int32) | no | Rows that match a contact in another campaign of the workspace, skipped because this campaign removes duplicates across campaigns. |
| `duplicateInSource` | integer (int32) | no | Rows that repeat an earlier row of the same import. |
| `alreadyContacted` | integer (int32) | no | Rows that match a contact emailed within the campaign's recently emailed window. |
| `blocklist` | integer (int32) | no | Rows that match the workspace's blocklist. |
| `failedValidation` | integer (int32) | no | Rows that failed row checks, such as a row with no first and last name or no company name or domain. |
| `salesNavigatorProfileUnresolved` | integer (int32) | no | Sales Navigator people Kenso could not turn into a LinkedIn profile URL, so no LinkedIn step could reach them. |
| `other` | integer (int32) | no | Rows skipped for any other reason, such as a row Kenso could not process. |
| `missingKey` | integer (int32) | no | Rows with no email and no LinkedIn URL, dropped by the `missingKey` List check fix. |
| `invalidEmail` | integer (int32) | no | Rows whose email Kenso knows is invalid, dropped by the `invalidEmail` List check fix. |
| `noMx` | integer (int32) | no | Rows whose email domain takes no mail (no MX record), dropped by the `noMx` List check fix. |
| `catchAll` | integer (int32) | no | Rows whose email domain accepts every address, dropped by the `catchAll` List check fix. |
| `personalEmail` | integer (int32) | no | Rows with a personal email address, such as Gmail or Outlook.com, dropped by the `personalEmail` List check fix. |
| `roleAddress` | integer (int32) | no | Rows with a role address such as info@ or sales@, dropped by the `roleAddress` List check fix. |
| `companyContacted` | integer (int32) | no | Rows at a company where someone else recently got a Kenso email, dropped by the `companyContacted` List check fix. |
| `companyCap` | integer (int32) | no | Rows past the first 5 people at one company, dropped by the `companyCap` List check fix. |

### InboxImportRow

One processed row of an inbox import.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `index` | integer (int32) | no | Zero-based position of the row in the request's `rows` array. |
| `email` | string | no | The row's email address. |
| `status` | string | no | The row's result: `connected`, `failed` or `skipped`. |
| `inboxId` | integer (int64) | no | The connected inbox, the existing inbox a skipped row matched, or the disconnected inbox a failed connect left in the workspace. Omitted when there is none. |
| `errorCode` | string | no | Why the row did not connect, omitted for a connected row. A skipped row has `already_exists`, `duplicate_in_file`, or `feature_disabled` or `forbidden` when the import stopped before the row because inbox import was turned off for the workspace or the member who started it lost Delivery edit. A failed row has `email_in_use` (another Kenso inbox has the email), `host_failure_limit` (not tried, because its host refused several logins or could not be reached earlier in the import) or an API error code such as `validation_failed` or `service_unavailable`. |
| `message` | string | no | A readable message about the row's result, when Kenso has one. |
| `firstName` | string | no | On a connected row that set one in the file, the sender first name now on the mailbox. Omitted otherwise. |
| `lastName` | string | no | On a connected row that set one in the file, the sender last name now on the mailbox. Omitted otherwise. |
| `dailySendLimit` | integer (int32) | no | On a connected row that set one in the file, the daily limit now stored on the mailbox, after the provider ceiling. Omitted otherwise. |
| `warnings` | array of string | no | Warning codes of a row that connected, omitted when there are none: `daily_limit_clamped` (the row's `dailySendLimit` was above the mailbox's provider ceiling and was stored at the ceiling) or `settings_not_applied` (the mailbox connected, but its names or limit could not be saved). |
| `details` | array of InboxImportRowDetail | no | On a row that failed a column check, one entry per refused column, with `field` naming the column. Omitted otherwise. |

### InboxImportRowDetail

One refused column of an inbox import row.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `field` | string | no | The row column, such as `firstName` or `dailySendLimit`. |
| `code` | string | no | Stable code for the problem, such as `invalid`. |
| `message` | string | no | A sentence for people that says what is wrong with the column. |
