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

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_unentitled
  • forbidden
  • invalid_request
  • internal_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
  }
}

Was this page helpful?