---
search:
  tags:
    - Library creatives
    - POST
seo:
  description: >-
    Adds one required Placement to a Creative, and answers the… Reference for
    the POST /library/creatives/{creativeId}/placements endpoint in the AdCrunch
    API.
sidebar:
  label: Require a Placement
  badge: POST
title: Require a Placement
type: openapi-operation
---
Adds one required Placement to a Creative, and answers the read of the Creative with its slots. The new slot is empty until a Variation of the Creative names the Placement. When the Creative already requires the Placement, nothing changes and the answer is the same.

One Creative requires 50 Placements at most.

`POST /library/creatives/{creativeId}/placements`

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

- `placementId` (string, required) — The Placement to require. It must be a global Placement or one of your organization.

Request body example:

```json
{
  "placementId": "plm_meta_stories_video"
}
```

**Responses**

- `200` — The Creative, with its required Placements after the add.
- `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 Creative with that id in this organization, or no Placement with that \`placementId\` that this organization sees. A deleted Creative or Placement answers this too. \`error\` is \`not\_found\`.
- `409` — The Creative already requires 50 Placements, which is the most. Nothing was written. \`error\` is \`creative\_placement\_limit\`.

Response example, 200:

```json
{
  "createdAt": 1790000300000,
  "createdBy": "usr_2e5b84",
  "deletedAt": null,
  "id": "crv_5e2a19",
  "name": "Spring sale",
  "organizationId": "org_3a7f10",
  "updatedAt": null,
  "variationCount": 2,
  "requiredPlacements": [
    {
      "channel": "meta",
      "id": "plm_meta_feed_image",
      "isFilled": false,
      "name": "Meta Feed image",
      "type": "image"
    },
    {
      "channel": "meta",
      "id": "plm_meta_stories_video",
      "isFilled": true,
      "name": "Meta Stories video",
      "type": "video"
    }
  ],
  "variations": {
    "data": [
      {
        "asset": {
          "contentHash": "9d2f41b7c6e8a35014f7b2d9c3e6a810",
          "createdAt": 1790000000000,
          "createdBy": "usr_2e5b84",
          "deletedAt": null,
          "durationMs": 15000,
          "failureCode": null,
          "failureReason": null,
          "filename": "spring-sale.mp4",
          "height": 1920,
          "id": "ast_7c1e9a",
          "key": "org_3a7f10/ast_7c1e9a",
          "kind": "video",
          "mimeType": "video/mp4",
          "name": "Spring sale 9:16",
          "organizationId": "org_3a7f10",
          "sizeBytes": 24117248,
          "status": "ready",
          "updatedAt": 1790000120000,
          "width": 1080
        },
        "assetId": "ast_7c1e9a",
        "brokenRules": [],
        "createdAt": 1790000360000,
        "createdBy": "usr_2e5b84",
        "creativeId": "crv_5e2a19",
        "deletedAt": null,
        "id": "var_8c3f60",
        "organizationId": "org_3a7f10",
        "placement": {
          "channel": "meta",
          "id": "plm_meta_stories_video",
          "name": "Meta Stories video",
          "type": "video"
        },
        "placementId": "plm_meta_stories_video",
        "unknownRules": [],
        "updatedAt": null
      },
      {
        "asset": {
          "contentHash": "4a7e1c9b0d3f26854b1e7a9c2d6f3081",
          "createdAt": 1789900000000,
          "createdBy": "usr_2e5b84",
          "deletedAt": null,
          "durationMs": null,
          "failureCode": null,
          "failureReason": null,
          "filename": "spring-sale-square.jpg",
          "height": 1080,
          "id": "ast_2d4f83",
          "key": "org_3a7f10/ast_2d4f83",
          "kind": "image",
          "mimeType": "image/jpeg",
          "name": null,
          "organizationId": "org_3a7f10",
          "sizeBytes": 486112,
          "status": "ready",
          "updatedAt": 1789900090000,
          "width": 1080
        },
        "assetId": "ast_2d4f83",
        "brokenRules": [],
        "createdAt": 1790000350000,
        "createdBy": "usr_2e5b84",
        "creativeId": "crv_5e2a19",
        "deletedAt": null,
        "id": "var_1d7b42",
        "organizationId": "org_3a7f10",
        "placement": null,
        "placementId": null,
        "unknownRules": [],
        "updatedAt": null
      }
    ]
  }
}
```
