library_creative_create
Create a Creative in your Library, one ad idea, with no Variation yet.
Ask to keep the files of one ad idea together. The agent creates a Creative, and then adds a Variation for each file.
“Make a creative called Spring sale with the teaser video and the square banner.”
The agent calls this tool with the name, and then calls variation_add once for each file. You then see the Creative with its two Variations. The Creative stays in AdCrunch, and no ad account changes.
This tool is part of the job Bring your own creative.
Reference
Create a Creative in your Library: one ad idea, with no Variation yet. Then add a Variation for each rendition of the idea with variation_add, for example a 9:16 video and a square image. 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. The Creative stays in AdCrunch: this changes no ad account.
Input
| Argument | Type | Required | Description |
|---|---|---|---|
name |
string, at most 255 characters or null | no | The name of the Creative, for people. A blank name or null stores no name. There is no fallback name. |
Output
A successful call returns this object in structuredContent.
| Field | Type | Always present | Description |
|---|---|---|---|
creative |
object | yes | The new Creative. Its variationCount is 0. |
creative.createdAt |
number | yes | Milliseconds since the Unix epoch, UTC. |
creative.createdBy |
string | yes | The user who created the Creative. |
creative.deletedAt |
number or null | yes | Always null here. A deleted Creative is not answered. |
creative.id |
string | yes | The id of the Creative, crv_…. |
creative.name |
string or null | yes | The name a person gave the Creative. null when nobody named it. There is no fallback name. |
creative.organizationId |
string | yes | The organization that owns the Creative. |
creative.updatedAt |
number or null | yes | When the Creative last changed, in milliseconds since the Unix epoch, UTC. null until its first rename. |
creative.variationCount |
number | yes | How many live Variations the Creative holds. The read of one Creative holds the first page of them, and the list of the Variations of the Creative gives each page. |
Failure codes
A failed call has isError set, and structuredContent.error holds one of these codes. Errors describes the shape of a failed call.
organization_unentitledforbiddeninvalid_requestinternal_error
Scope
The token must hold library: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.
- Not idempotent. A second call with the same arguments can change more.
- Closed world. The tool reads and writes the data of AdCrunch only.
Example
The arguments:
{
"name": "Spring sale"
}
The result, in structuredContent:
{
"creative": {
"createdAt": 1790000300000,
"createdBy": "usr_2e5b84",
"deletedAt": null,
"id": "crv_5e2a19",
"name": "Spring sale",
"organizationId": "org_3a7f10",
"updatedAt": null,
"variationCount": 0
}
}