v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
labels

Apply label to entity

Closed beta

Apply a label to one or more campaigns. Future releases may support labels for other entities in addition to campaigns. Currently, you can apply brand and custom labels. Future releases will provide more options.

Note: You can only apply one brand label to a campaign. You can apply up to 30 custom labels to a campaign.

post/ad_accounts/{ad_account_id}/labels/{label_id}/apply

Path parameters

ad_account_idstring required
label_idstring required

Label ID.

Request body

entity_idsstring[] required

Entity IDs to apply label to.

Response

The request has succeeded.

Example response

{
  "entities_labels": [
    {
      "entity_type": "CAMPAIGN"
    }
  ],
  "errors": [
    {
      "data": {
        "entity_type": "CAMPAIGN"
      }
    }
  ]
}