---
title: library_creative_create
description: 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`](/mcp/tools/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](/mcp/tools/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](/mcp/errors) describes the shape of a failed call.

- `organization_unentitled`
- `forbidden`
- `invalid_request`
- `internal_error`

### Scope

The token must hold `library:write`. [Auth & scopes](/mcp/auth) 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:

```json
{
  "name": "Spring sale"
}
```

The result, in `structuredContent`:

```json
{
  "creative": {
    "createdAt": 1790000300000,
    "createdBy": "usr_2e5b84",
    "deletedAt": null,
    "id": "crv_5e2a19",
    "name": "Spring sale",
    "organizationId": "org_3a7f10",
    "updatedAt": null,
    "variationCount": 0
  }
}
```
