# createCallList

Build a call list from contact ids, dialed in the order given (duplicates collapse). Every contact must be one you can open, or the whole build is refused. Collect the ids with filterContacts, ANDing in the condition {id: "dnc", fieldId: "doNotContact", value: false} (an OR root goes under a new AND root beside it; leave it out only when the person asked to override do-not-contact), so the count on your yes card leaves them out; a result cut short hides some rows’ flags, so never say none are do-not-contact from one. Optional build rules, frozen onto the list: maxNumbersPerContact (default 3), includeRelatives (default false), overrideDnc and overrideLitigator (default false; turning either on dials people who asked not to be called or are a litigation risk, so ask the person first), reachedTagId (a contact tag applied to everyone the run reaches). visibilityScope is USER (only you, the default) or ORG (your whole team). Pass buildAttemptKey (any unique string) and resend it unchanged on a retry so a lost response never builds a second list. A list nobody in the org can dial from (no calling line) is refused. Contacts the list cannot call (no number, do-not-contact, litigator) are left off and counted in cannotCallCount; truncatedCount counts contacts past the 10,000 cap. Returns the new list with its dialPath.

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

## Variables

- `name`: `String`
- `contactIds`: `[ID!]!` (required)
- `visibilityScope`: `String` (default `"USER"`)
- `maxNumbersPerContact`: `Int`
- `includeRelatives`: `Boolean`
- `overrideDnc`: `Boolean`
- `overrideLitigator`: `Boolean`
- `reachedTagId`: `ID`
- `buildAttemptKey`: `String`

## Response (data, an example)

```json
{
  "callListsMutation": {
    "createCallList": {
      "callList": {
        "id": "<ID>",
        "name": "…",
        "status": "…",
        "visibilityScope": "…",
        "maxNumbersPerContact": 0,
        "includeRelatives": true,
        "overrideDnc": true,
        "overrideLitigator": true,
        "cursorPosition": 0,
        "startedAt": "2026-01-01T00:00:00.000Z",
        "endedAt": "2026-01-01T00:00:00.000Z",
        "dialPath": "…",
        "createdByUser": {
          "id": "<ID>",
          "firstName": "…",
          "lastName": "…"
        },
        "lockedByUser": {
          "id": "<ID>",
          "firstName": "…",
          "lastName": "…"
        },
        "reachedTag": {
          "id": "<ID>",
          "name": "…"
        },
        "counts": {
          "total": 0,
          "pending": 0,
          "completed": 0,
          "skipped": 0,
          "dials": 0,
          "byDisposition": [
            {
              "disposition": "…",
              "count": 0
            }
          ]
        }
      },
      "truncatedCount": 0,
      "cannotCallCount": 0
    }
  }
}
```

## 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": "createCallList",
    "variables": {
      "contactIds": [
        "<contactIds>"
      ]
    }
  }'
```