---
search:
  tags:
    - Library placement groups
    - POST
seo:
  description: >-
    Adds a Placement to a group of your organization, and… Reference for the
    POST /library/placement-groups/{groupId}/placements endpoint in the AdCrunch
    API.
sidebar:
  label: Add a Placement to a group
  badge: POST
title: Add a Placement to a group
type: openapi-operation
---
Adds a Placement to a group of your organization, and answers the group with its Placements. The Placement can be global or of your organization, of any channel. When the group already holds it, nothing changes and the answer is the same.

A global group cannot change: it answers `404`.

`POST /library/placement-groups/{groupId}/placements`

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

- `placementId` (string, required) — The Placement to add. It can be global or of your organization.

Request body example:

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

**Responses**

- `200` — The group, with its 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 Placement group of your organization with that id. A global group answers this too, because only AdCrunch changes one. \`error\` is \`not\_found\`. Or no live Placement with the \`placementId\` that your organization sees.

Response example, 200:

```json
{
  "createdAt": 1790000600000,
  "createdBy": "usr_2e5b84",
  "deletedAt": null,
  "description": null,
  "id": "plg_9e1c53",
  "isGlobal": false,
  "name": "Vertical video",
  "organizationId": "org_3a7f10",
  "updatedAt": null,
  "placements": [
    {
      "channel": "meta",
      "createdAt": 1790000500000,
      "createdBy": "usr_2e5b84",
      "deletedAt": null,
      "description": "Our own cut for Reels, never over 30 seconds.",
      "id": "plm_4b8d27",
      "isGlobal": false,
      "name": "Reels short cut",
      "organizationId": "org_3a7f10",
      "params": {
        "rules": [
          {
            "operator": {
              "condition": "eq",
              "value": [
                9,
                16
              ]
            },
            "type": "ratio"
          },
          {
            "operator": {
              "condition": "lte",
              "value": 30000
            },
            "type": "duration"
          }
        ],
        "type": "video"
      },
      "type": "video",
      "updatedAt": null
    },
    {
      "channel": "meta",
      "createdAt": 1789000000000,
      "createdBy": null,
      "deletedAt": null,
      "description": null,
      "id": "plm_meta_stories_video",
      "isGlobal": true,
      "name": "Meta Stories video",
      "organizationId": null,
      "params": {
        "rules": [
          {
            "operator": {
              "condition": "eq",
              "value": [
                9,
                16
              ]
            },
            "type": "ratio"
          },
          {
            "operator": {
              "condition": "gte",
              "value": 250
            },
            "type": "width"
          },
          {
            "operator": {
              "condition": "in",
              "value": [
                "video/mp4",
                "video/quicktime"
              ]
            },
            "type": "mime"
          },
          {
            "operator": {
              "condition": "gte",
              "value": 1000
            },
            "type": "duration"
          }
        ],
        "type": "video"
      },
      "type": "video",
      "updatedAt": null
    }
  ]
}
```
