---
search:
  tags:
    - Library placement groups
    - POST
seo:
  description: >-
    Creates a Placement group of your organization: a named set of Placements.
    A… Reference for the POST /library/placement-groups endpoint in the AdCrunch
    API.
sidebar:
  label: Create a Placement group
  badge: POST
title: Create a Placement group
type: openapi-operation
---
Creates a Placement group of your organization: a named set of Placements. A group has no channel, and it holds Placements of any channel that your organization sees. The new group holds no Placement: add each one with `POST /library/placement-groups/{groupId}/placements`.

The name must be unique, ignoring case, among the groups that your organization sees. An organization holds 50 live groups at most.

`POST /library/placement-groups`

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

- `description` (string | null) — A free text, up to 1000 characters. AdCrunch trims it. An empty string is stored as no description.
- `name` (string, required) — The name, 1 to 80 characters. AdCrunch trims it. It must be unique, ignoring case, among the ones that your organization sees.

Request body example:

```json
{
  "name": "Vertical video"
}
```

**Responses**

- `201` — The new group, with \`isGlobal\` false.
- `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\`.
- `409` — The group cannot be created now. \`name\_taken\`: a live group that your organization sees holds this name, ignoring case. \`placement\_group\_limit\`: your organization holds 50 live groups.

Response example, 201:

```json
{
  "createdAt": 1790000600000,
  "createdBy": "usr_2e5b84",
  "deletedAt": null,
  "description": null,
  "id": "plg_9e1c53",
  "isGlobal": false,
  "name": "Vertical video",
  "organizationId": "org_3a7f10",
  "updatedAt": null
}
```
