# createCallListFromContactFilter

Build a call list from a saved CONTACT filter (`filterId` from listContactFilters): the contacts it matches for you right now, in the filter's order, up to 10,000. The list is a snapshot; it does not follow later changes to the filter. Before the yes, count it with countContacts on a new AND root holding the filter's own tree (the root getFilter returns) and {id: "dnc", fieldId: "doNotContact", value: false} (without that condition when the person asked to override do-not-contact), and say do-not-contact people are left off. 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": "createCallListFromContactFilter", "variables": {...} }`
- Scope: `WRITE`
- Type: mutation
- Idempotency: honors `Idempotency-Key` (24 h)
- Rate-limited: no

## Variables

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

## Response (data, an example)

```json
{
  "callListsMutation": {
    "createCallListFromContactFilter": {
      "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": "createCallListFromContactFilter",
    "variables": {
      "filterId": "<filterId>"
    }
  }'
```