# startContactImport

Start importing contacts from a spreadsheet the person attached to the chat. Pass artifactId, the shelf id the chat names for the file (`[shelf id …]`). It creates the same upload the Import page creates (it shows on the Files page) and runs the import mapper on it, which takes up to a few minutes, then returns the import (its id is the fileProcessingTaskId every other contactImports operation takes), the file row count (totalRows) and its columns with example values (csvSample). Nothing is imported yet. transformerAuthoringState COMPLETED with hasAuthoredTransformer true means the mapping is ready: read it with previewContactImport. IN_PROGRESS means another mapping run on this upload is still going: wait a little and call authorContactImportMapping. Only .csv, .xlsx and .xls files can be imported (spreadsheets are stored as CSV). Call it once per file and keep the id; a second call for a file whose import is not confirmed yet returns that same import.

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "startContactImport", "variables": {...} }`
- Scope: `WRITE`
- Type: mutation
- Idempotency: honors `Idempotency-Key` (24 h)
- Rate-limited: no

## Variables

- `artifactId`: `ID!` (required)

## Response (data, an example)

```json
{
  "fileProcessingTaskMutation": {
    "startContactImportFromArtifact": {
      "id": "<ID>",
      "status": "CREATED",
      "transformerAuthoringState": "COMPLETED",
      "hasAuthoredTransformer": true,
      "totalRows": 0,
      "csvSample": [
        {
          "header": "…",
          "exampleData": [
            "…"
          ]
        }
      ]
    }
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "operationId": "startContactImport",
    "variables": {
      "artifactId": "<artifactId>"
    }
  }'
```