# bulkAddLabelsToCreators

Mutation

Assign labels to up to 1,000 creators in the background; returns an operationId to poll with `operation(id:)`.

Available to agents as MCP tool `bulkAddLabelsToCreators` — see [Write tools](/api/v2/docs/mcp/write-tools#bulk-add-labels-to-creators).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `creatorIds` | `[ID!]!` | Yes | — | Creator ids to label, as returned by `searchCreators` or `creator`. At least 1 and at most 1000. An id that does not resolve in this workspace is skipped and returned in `skippedCreatorIds`; the rest are scheduled. |
| `labelNames` | `[String!]!` | Yes | — | Label names to assign. At least 1 and at most 50, each at most 100 characters. Matching ignores case and surrounding whitespace; a name that matches no label creates it. |

## Returns

| Name | Type | Description |
| --- | --- | --- |
| `acceptedCount` | `Int!` | Number of distinct creators scheduled. |
| `operationId` | `ID` | The background operation; poll it with `operation(id:)` and its per-creator outcomes with `operationRecords`. Null when `scheduled` is false. |
| `scheduled` | `Boolean!` | True when an operation was scheduled. False when userErrors is non-empty or when no creator id resolved in this workspace. |
| `skippedCreatorIds` | `[ID!]!` | Submitted creator ids that do not resolve in this workspace and were not scheduled. |
| `userErrors` | [`[UserError!]!`](/api/v2/docs/types/user-error) | Errors that refused the whole request: an empty or oversized list, a blank or over-long name, a label being deleted, too many label bulk operations already in flight, or a workspace with no user to attribute the operation to. Empty on success. |

## Examples

### Bulk add labels to creators

Schedule a background operation that assigns a label to many creators by name.

```graphql
mutation BulkAddLabelsToCreatorsDefault($creatorIds: [ID!]!, $labelNames: [String!]!) {
  bulkAddLabelsToCreators(creatorIds: $creatorIds, labelNames: $labelNames) {
    scheduled
    operationId
    acceptedCount
    skippedCreatorIds
    userErrors {
      field
      message
    }
  }
}
```

Variables:

```json
{
  "creatorIds": [
    "7750875f-6037-5751-a493-86ac5fc3e9c9",
    "75fd5375-7f33-5331-a6cf-86e0c697c6f6"
  ],
  "labelNames": [
    "Plant Parents"
  ]
}
```

Response — HTTP 200:

```json
{
  "data": {
    "bulkAddLabelsToCreators": {
      "scheduled": true,
      "operationId": "bb437896-b6cb-5c2e-9d2b-a838b77bf025",
      "acceptedCount": 2,
      "skippedCreatorIds": [],
      "userErrors": []
    }
  }
}
```