# addLabelsToCreators

Mutation

Assign labels to creators by name, creating any name the workspace does not carry yet. Priced per creator; for large batches use `bulkAddLabelsToCreators`.

Available to agents as MCP tool `addLabelsToCreators` — see [Write tools](/api/v2/docs/mcp/write-tools#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 40. If any id does not resolve in this workspace, the WHOLE call is rejected (all-or-nothing) with a userErrors entry naming it under `creatorIds`; nothing is written. |
| `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 |
| --- | --- | --- |
| `creators` | [`[Creator!]!`](/api/v2/docs/types/creator) | The creators as stored after the write. Empty when userErrors is non-empty. |
| `userErrors` | [`[UserError!]!`](/api/v2/docs/types/user-error) | Errors that refused the whole request: an empty or oversized list, a call costing more than the workspace's rate-limit capacity, a blank or over-long name, an unknown creator id, a label being deleted, more than one label assignment in the same request, or a workspace with no user to attribute the write to. Empty on success. |

## Examples

### Add labels to creators

Assign a label to creators by name; the label is matched ignoring case.

```graphql
mutation AddLabelsToCreatorsDefault($creatorIds: [ID!]!, $labelNames: [String!]!) {
  addLabelsToCreators(creatorIds: $creatorIds, labelNames: $labelNames) {
    creators {
      id
      customAttributes
    }
    userErrors {
      field
      message
    }
  }
}
```

Variables:

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

Response — HTTP 200:

```json
{
  "data": {
    "addLabelsToCreators": {
      "creators": [
        {
          "id": "75fd5375-7f33-5331-a6cf-86e0c697c6f6",
          "customAttributes": {
            "age": null,
            "emails": [],
            "gender": "45b18b20-e86d-5c85-831c-19ada8104b25",
            "labels": [
              "Gifting"
            ],
            "location": "United States",
            "full_name": null,
            "phone_numbers": []
          }
        },
        {
          "id": "7750875f-6037-5751-a493-86ac5fc3e9c9",
          "customAttributes": {
            "age": null,
            "emails": [],
            "gender": "52e6750a-79ca-5f7e-9352-228c7b9cb18f",
            "labels": [
              "Gifting"
            ],
            "location": "United States",
            "full_name": null,
            "phone_numbers": []
          }
        }
      ],
      "userErrors": []
    }
  }
}
```