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

library_creative_list

List the Creatives of your Library, each with its count of Variations.

Ask which ad ideas your Library holds. The agent lists the Creatives of your organization, newest first. Each Creative comes with the number of its Variations.

“Which creatives do we have in the library?”

The agent calls this tool, and calls it again for each next page until the list ends. You see each Creative with its name and its number of Variations. A Creative of your Library is not the creative of an ad account: list_creatives lists those.

This tool is part of the job Bring your own creative.

Reference

List the Creatives of the active organization’s Library, newest first, each with its count of Variations. A Variation is one rendition of the Creative, and it holds one Asset. 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. Use library_creative_get to read one Creative with its Variations. The answer holds at most limit rows (default 100, maximum 500). When it carries nextCursor, more rows exist: call this tool again with the same arguments and cursor set to that value. When it carries no nextCursor, you have every row.

Input

Argument Type Required Description
cursor string, at least 1 character no The nextCursor of the previous page. Omit it to get the first page. Send it with no change, and with the same filters as the request that answered it: a cursor from a different query gets a 400 invalid_cursor. Do not build or change a cursor.
limit integer, 1 to 500 no The greatest number of rows on the page, from 1 to 500. The default is 100. A greater value gets a 400, with error of invalid_request. Default: 100.

Output

A successful call returns this object in structuredContent.

Field Type Always present Description
creatives array of object yes The Creatives of this page, newest first, each with its count of Variations and no Variation. A deleted Creative is not in the list.
creatives[].createdAt number yes Milliseconds since the Unix epoch, UTC.
creatives[].createdBy string yes The user who created the Creative.
creatives[].deletedAt number or null yes Always null here. A deleted Creative is not answered.
creatives[].id string yes The id of the Creative, crv_….
creatives[].name string or null yes The name a person gave the Creative. null when nobody named it. There is no fallback name.
creatives[].organizationId string yes The organization that owns the Creative.
creatives[].updatedAt number or null yes When the Creative last changed, in milliseconds since the Unix epoch, UTC. null until its first rename.
creatives[].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.
nextCursor string no Send this value as cursor to get the next page. It is absent on the last 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.

  • invalid_cursor
  • organization_unentitled
  • forbidden
  • invalid_request
  • internal_error

Scope

The token must hold library:read. 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.

  • Read-only. The tool changes nothing.
  • Closed world. The tool reads and writes the data of AdCrunch only.

Example

The arguments:

{
  "limit": 20
}

The result, in structuredContent:

{
  "creatives": [
    {
      "createdAt": 1790000300000,
      "createdBy": "usr_2e5b84",
      "deletedAt": null,
      "id": "crv_5e2a19",
      "name": "Spring sale",
      "organizationId": "org_3a7f10",
      "updatedAt": null,
      "variationCount": 2
    }
  ]
}

Was this page helpful?