---
title: campaign_plan_creative_add
description: Put a Creative of your Library into the pool of a Campaign Plan.
---

Ask to add a Creative to a Campaign Plan before you decide which Line Item uses it.

> "Add the summer creative to the spring sale plan."

The agent calls `campaign_plan_creative_add` with the slug of the Campaign Plan and the id of the Creative. To find the Creative, the agent calls [`library_creative_list`](/mcp/tools/library-creative-list). The answer is the pool after the call.

- **The Creative goes into the pool, and onto no Line Item.** To give it to a Line Item, the agent calls [`line_item_creative_add`](/mcp/tools/line-item-creative-add). That tool also puts a Creative into the pool, so this tool is for a Creative that has no Line Item yet.
- **The Creative must be in your Library.** An unknown Creative and a deleted Creative are refused with `not_found`.
- **A Creative with no Variation is valid.**
- **The call is idempotent.** A second call with the same Creative changes nothing.
- **A pool holds at most 50 Creatives.** The next add is refused with `creative_limit`.
- **The plan does not change.** Its revision stays, and an approved plan stays approved.

## Reference

Put a Creative of the Library into the pool of a Campaign Plan. The answer is the pool after the call. A Campaign Plan holds a pool of Creatives of the Library, at most 50. Each Line Item picks its Creatives from the pool of its Campaign Plan, at most 20. A Line Item does not use the Creatives of the pool that it did not pick. After this call the Creative is in the pool and on no Line Item: line_item_creative_add gives it to a Line Item, and that Tool also puts a Creative into the pool, so call this Tool only for a Creative that has no Line Item yet. Adding a Creative that is in the pool already changes nothing. A Creative with no Variation is valid. The call does not change the revision or the status of the Campaign Plan or of a Line Item: a validated Line Item stays validated. A Creative of your Library is an ad idea of your organization, with its Variations. It is not the creative of an ad account, which list_creatives lists.

### Input

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `campaign_plan_name` | string | yes | The Campaign Plan slug — its stable per-organization handle. |
| `creative_id` | string | yes | The id of a Creative of the Library, `crv_…`. library_creative_list gives the Creatives of the organization. |

### Output

A successful call returns this object in `structuredContent`.

| Field | Type | Always present | Description |
| --- | --- | --- | --- |
| `creatives` | array of object | yes | The Creatives of the pool, oldest first, at most 50: the whole pool, in one answer. A Creative that was deleted in the Library is not listed. |
| `creatives[].id` | string | yes | The id of the Creative in the Library, `crv_…`. |
| `creatives[].name` | string or null | yes | The name of the Creative, or `null` when it has none. |
| `creatives[].variationCount` | number | yes | The number of Variations of the Creative. `library_creative_get` gives them. |
| `creatives[].lineItemIds` | array of string | yes | The ids of the Line Items of the Campaign Plan that use the Creative. Empty when the Creative is not assigned to a Line Item yet. |

### Failure codes

A failed call has `isError` set, and `structuredContent.error` holds one of these codes. [Errors](/mcp/errors) describes the shape of a failed call.

- `not_found`
- `creative_limit`
- `organization_unentitled`
- `forbidden`
- `invalid_request`
- `internal_error`

### Scope

The token must hold `campaign_plan:write`. [Auth & scopes](/mcp/auth) lists each scope.

### Annotations

A client reads these hints. A hint that the tool does not declare has the default value of the MCP specification.

- **Writes.** The tool can change data.
- **Not destructive.** The tool makes only additive changes.
- **Idempotent.** A second call with the same arguments changes nothing more.
- **Closed world.** The tool reads and writes the data of AdCrunch only.

### Example

The arguments:

```json
{
  "campaign_plan_name": "spring-sale",
  "creative_id": "crv_8c2e47"
}
```

The result, in `structuredContent`:

```json
{
  "creatives": [
    {
      "id": "crv_8c2e47",
      "name": "Spring sale",
      "variationCount": 2,
      "lineItemIds": []
    }
  ]
}
```
