---
search:
  tags:
    - Library creatives
    - POST
seo:
  description: >-
    Creates a Creative: an ad idea of your organization, before any provider
    gets it. The… Reference for the POST /library/creatives endpoint in the
    AdCrunch API.
sidebar:
  label: Create a Creative
  badge: POST
title: Create a Creative
type: openapi-operation
---
Creates a Creative: an ad idea of your organization, before any provider gets it. The new Creative holds no Variation. Add each rendition of the idea, for example the 9:16 cut and the square cut, as a Variation.

A Creative has no link to a provider creative, an advertiser or a Campaign Plan.

Name the Placements that the Creative requires with `placementIds`, with a preset group in `placementGroupId`, or with both. Each required Placement is a slot: it is empty until a Variation of the Creative names the Placement. The Creative and its required Placements are written together. The answer does not list them: read the Creative to see its slots.

`POST /library/creatives`

**Request body** (`application/json`, required)

- `name` (string | null) — The name of the Creative. AdCrunch trims it. Leave it out, or send \`null\` or an empty string, for a Creative with no name.
- `placementGroupId` (string) — A Placement group, used as a preset. AdCrunch adds its Placements to the required Placements at this moment, and keeps no link to the group: a later change of the group changes no Creative. It must be a global group or one of your organization.
- `placementIds` (string[]) — The Placements that the Creative requires. Each one is a slot to fill. Each must be a global Placement or one of your organization. The Placements of \`placementGroupId\` join this list, and a Placement that is in both counts one time. 50 at most in all. Leave it out for a Creative with no required Placement.

Request body example:

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

**Responses**

- `201` — The new Creative, with no Variation.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`library:write\`. \`error\` is \`forbidden\`.
- `404` — No Placement with one of the \`placementIds\`, or no group with that \`placementGroupId\`, that this organization sees. Nothing was written. \`error\` is \`not\_found\`.
- `409` — The Creative would require more than 50 Placements, counting the Placements of the group. Nothing was written. \`error\` is \`creative\_placement\_limit\`.

Response example, 201:

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