Skip to content
AdCrunch
Esc
↑↓navigate↵open⌘Jpreview
On this page

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_found
  • creative_limit
  • organization_unentitled
  • forbidden
  • invalid_request
  • internal_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": []
    }
  ]
}

Was this page helpful?