# Import contacts `POST /api/v1/lists/{list_id}/contacts/import` Imports contacts from a CSV file. A row with a matching email updates that contact in this list. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Lists → Write**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the record belongs to. ## Path parameters - `list_id` (integer, required) — ID of the contact list. ## Body parameters - `file` (CSV file, required) — Upload as multipart/form-data. Include a header row. Use commas, semicolons, or tabs. Accepted columns include `firstname`, `surname`, `company`, `email`, `phone`, `communication_consent`, and `is_active`. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request POST \ --url "https://api.asdincloud.com/api/v1/lists/${LIST_ID:?Set LIST_ID}/contacts/import" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --form "file=@./contacts.csv;type=text/csv" ``` ## Response **200 OK** Returns counts and any row errors in `data`. Each row error has a line number and reason. Example with fictional data and selected fields. ```json { "message_key": "entities.list_contact.messages.imported", "data": { "created": 1, "updated": 0, "skipped": 0, "errors": [] } } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `400` — Supply a valid upload with a .csv filename. - `404` — The requested record was not found.