# confirmContactImport

Import every row of the spreadsheet as contacts: the step the Import page’s Import button runs. Rows that match an existing contact update it instead of duplicating it. Every import puts its contacts on its own list, “Contacts from <file name>”; tagName adds a second list of that name (optional; a list, not a tag), so pass it only for a list the person named or picked, never one you made from the file’s name. attestationAccepted records that the person affirmed they have a lawful basis to contact everyone on the list; the import is refused without it, so pass true only on their yes (in a chat, their yes on the import task’s approval card, which shows the attestation). reviveArchivedMatches (default true) restores archived contacts the file matches. optOutTagName is the tag the mapping puts on the file’s opt-outs (a DNC column or tag, for example "DNC"): when the import finishes, every contact it imported that carries that tag is marked Do Not Contact, as part of the import, so nothing waits on it to mark them; omit it when the file marks nobody. Only after the person has seen the preview and said yes to importing this file, with this list. It starts a background task and returns at once; the chat that started it is told when it finishes, so never wait on it.

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

## Variables

- `fileProcessingTaskId`: `ID!` (required)
- `tagName`: `String`
- `attestationAccepted`: `Boolean!` (required)
- `reviveArchivedMatches`: `Boolean`
- `optOutTagName`: `String`

## Response (data, an example)

```json
{
  "fileProcessingTaskMutation": {
    "confirmContactTransformerUpload": {
      "id": "<ID>",
      "status": "CREATED"
    }
  }
}
```

## 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": "confirmContactImport",
    "variables": {
      "fileProcessingTaskId": "<fileProcessingTaskId>",
      "attestationAccepted": true
    }
  }'
```