---
title: "Add labels to placement"
type: reference
method: POST
path: /rest-api/placements/labels/add.do
tag: "Placements"
---

# Add labels to placement

`POST https://YOUR-NETWORK-DOMAIN/rest-api/placements/labels/add.do`

Adds one or more labels to an existing placement identified by its numeric ID. Labels that do not yet exist in the system are created when the requester holds the Create Labels permission. The response includes the placement ID and the complete set of labels currently assigned to it. The requester needs the Placement Labels permission and UPDATE permission on the parent site's inventory, otherwise the call answers {"success":false,"errors":{"permission_denied":...}} and nothing is created. To change labels of many placements at once, or to replace or remove labels, use POST /rest-api/placements/labels.do.

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `placementId` | integer | yes | `4001` | Unique numeric ID of the placement to add labels to |
| `labels` | array<string> | yes | `premium` | List of label names to add to the placement |

## Responses

- `200` — Labels added successfully
- `400` — A label does not exist and the requester may not create labels
- `401` — Authentication error
- `403` — Forbidden — insufficient permissions

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/placements/labels/add.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'placementId=4001' \
  --data-urlencode 'labels=premium'
```

Source: https://epom.com/ad-server/docs/api/placements/post-placements-labels-add