# enrollInWorkflow

Enroll MANY contacts in one CONTACT workflow's ACTIVE version: the app's bulk "Add to workflow" on the Contacts table. ASYNC bulk task: returns a bulkTaskId before anything runs; poll getBulkTask. TWO selection forms, never combined. EXPLICIT: `contactIds`. FILTER-BACKED: `filterId` (a saved contact filter from listContactFilters; a teammate's private one is refused) OR `filterTree` (inline, saveFilter's CONTACT DSL, parsed STRICTLY) with `selectCount: N`, the first N matches in the filter's default order; `excludeIds` drops contacts from that window. NO select-all: a filter without selectCount is refused, so size the window with countContacts first. CAP: 20,000 contacts per call (the app's bulk-action limit, charged on the ids or selectCount); split a bigger audience with excludeIds or narrower filters. The workflow must be CONTACT with an ACTIVE version (PROPERTY or DEAL is refused; one record at a time is triggerWorkflowRun). Each enrolled contact starts a run that can TEXT or EMAIL them under the workflow's send window, daily caps and the org's sending safety. State the workflow and contact count to the user and get a go-ahead BEFORE submitting.

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

## Variables

- `workflowGroupId`: `ID!` (required)
- `contactIds`: `[String!]`
- `filterId`: `ID`
- `filterTree`: `JSON`
- `selectCount`: `Int`
- `excludeIds`: `[String!]`

## Response (data, an example)

```json
{
  "contactMutation": {
    "createBulkTriggerWorkflowTask": {
      "mode": "SYNC",
      "bulkTaskId": "…"
    }
  }
}
```

## 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": "enrollInWorkflow",
    "variables": {
      "workflowGroupId": "<workflowGroupId>"
    }
  }'
```