> For the complete documentation index, see [llms.txt](https://docs.cekat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cekat.ai/api-documentation/crm/board/import-items-into-a-crm-board.md).

# Import items into a CRM board

Imports items from a CSV file into an existing board. The import runs in the background: this endpoint returns a `jobId` right away. Track it with `GET /api/crm/boards/{boardId}/imports`.

**CSV format**

* The first row is the header. It must include `item_name`; every other header must match a column name on the board (see `GET /api/crm/boards/{boardId}`).
* Cell values follow the same formats as when creating an item (see **Board**). For `select` and `dropdown` columns, use the label `id`.
* Maximum file size is 512 MiB.

**Result**

* Rows are saved independently, so one bad row does not stop the others.
* A job with any failed row ends with status `failed`, and the rows that were valid are still saved. The `reason` in the import history says which column caused the failure. The agent given as `agent_id` also receives a failure report with the failed rows by email.
* Send the request as `multipart/form-data` with only the two fields below; extra fields are rejected.

```json
{"openapi":"3.0.3","info":{"title":"Cekat Open API","version":"1.0.0"},"tags":[{"name":"Board","description":"A board is a custom CRM table, such as a deals pipeline. It has **groups** (sections), **columns** (fields), and **items** (rows).\n\n## Item values\nWhen you create or update an item, send each column value as a top-level field named after the column, for example `{\"item_name\": \"Deal A\", \"Status\": \"1\", \"Amount\": 2500000}`. Get column names, types and select options from `GET /api/crm/boards/{id}`.\n\n| Column type | Value format |\n| --- | --- |\n| `text`, `long_text`, `phone` | String |\n| `email` | Email address string |\n| `number` | Number (numeric strings are accepted) |\n| `date` | ISO 8601 date-time with time zone, for example `2026-10-20T09:00:00+07:00` |\n| `timeline` | `{\"from\": \"<ISO date-time>\", \"to\": \"<ISO date-time>\"}` |\n| `checkbox` | `true` or `false` |\n| `select` | One label `id` from the column's `settings.labels` |\n| `dropdown` | Array of label `id`s from the column's `settings.labels` |\n| `agents` | Array of agent IDs |\n| `contacts`, `companies`, `orders`, `subscriptions`, `references` | Array of IDs of those records |\n| `conversation` | Conversation ID |\n| `files` | Array of `{\"file_name\", \"file_url\", \"file_type\"}` objects |\n\nA value that fails validation does not fail the whole request: the item is still saved, `message` is `success_with_failures`, and each rejected value is listed in `failed`.\n"}],"servers":[{"url":"https://api.cekat.ai","description":"Production"}],"security":[{"CekatApiKey":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"CekatApiKey":{"type":"apiKey","in":"header","name":"api_key","description":"Your business's Cekat API key, from **Settings → Developers & API** in the Cekat dashboard (https://chat.cekat.ai/developers?section=apikeys). Available on the Business and Enterprise plans."},"BearerAuth":{"type":"http","scheme":"bearer","description":"The same Cekat API key, sent as `Authorization: Bearer YOUR_API_KEY`. Accepted only by endpoints under `/api/...`."}},"schemas":{"CrmBoardImportJob":{"type":"object","properties":{"jobId":{"type":"string","format":"uuid","description":"ID of the import job. Use it to find the job in `GET /api/crm/boards/{boardId}/imports`."},"status":{"type":"string","description":"Always `pending` when the job is created."}}},"ApiError":{"type":"object","description":"Error body returned by the `/api/...` endpoints.","properties":{"success":{"type":"boolean"},"message":{"type":"string"},"statusCode":{"type":"integer"},"error":{"type":"object","properties":{"message":{"type":"string"}}},"correlationId":{"type":"string","description":"Request ID. Include it when contacting Cekat support."}}},"RateLimitError":{"type":"object","properties":{"message":{"type":"string"}}}},"responses":{"ApiUnauthorized":{"description":"The API key is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"TooManyRequests":{"description":"Rate limit exceeded. Wait and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitError"}}}},"ServiceUnavailable":{"description":"A dependency is temporarily unavailable. Retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}},"paths":{"/api/crm/boards/{boardId}/imports":{"post":{"tags":["Board"],"operationId":"ImportCrmBoardItems","summary":"Import items into a CRM board","description":"Imports items from a CSV file into an existing board. The import runs in the background: this endpoint returns a `jobId` right away. Track it with `GET /api/crm/boards/{boardId}/imports`.\n\n**CSV format**\n- The first row is the header. It must include `item_name`; every other header must match a column name on the board (see `GET /api/crm/boards/{boardId}`).\n- Cell values follow the same formats as when creating an item (see **Board**). For `select` and `dropdown` columns, use the label `id`.\n- Maximum file size is 512 MiB.\n\n**Result**\n- Rows are saved independently, so one bad row does not stop the others.\n- A job with any failed row ends with status `failed`, and the rows that were valid are still saved. The `reason` in the import history says which column caused the failure. The agent given as `agent_id` also receives a failure report with the failed rows by email.\n- Send the request as `multipart/form-data` with only the two fields below; extra fields are rejected.\n","parameters":[{"name":"boardId","in":"path","required":true,"description":"The board to import into.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["agent_id","file"],"properties":{"agent_id":{"type":"string","format":"uuid","description":"ID of the agent the import runs as. The import is recorded under this agent, and they receive the failure report if rows fail. Get agent IDs from `GET /api/agents`."},"file":{"type":"string","format":"binary","description":"The CSV file to import. The file name must end in `.csv` and the file can't be empty."}}},"encoding":{"file":{"contentType":"text/csv"}}}}},"responses":{"202":{"description":"The import was accepted and queued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmBoardImportJob"}}}},"400":{"description":"The request is invalid. For example, the body is not `multipart/form-data`, `file` or `agent_id` is missing, the file is empty or not a `.csv`, or the form has extra fields.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"$ref":"#/components/responses/ApiUnauthorized"},"403":{"description":"The agent or board isn't allowed for this business.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"The import job can't be processed in its current state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"The file is larger than 512 MiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```
