campaign_plan_creative_add
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. 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. 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 describes the shape of a failed call.
not_foundcreative_limitorganization_unentitledforbiddeninvalid_requestinternal_error
Scope
The token must hold campaign_plan:write. Auth & scopes 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:
{
"campaign_plan_name": "spring-sale",
"creative_id": "crv_8c2e47"
}
The result, in structuredContent:
{
"creatives": [
{
"id": "crv_8c2e47",
"name": "Spring sale",
"variationCount": 2,
"lineItemIds": []
}
]
}