Skip to main content

Create Ad Label

POST 

/api/advertising/labels

Creates an advertising label.

Required scope: advertising:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Body fields

  • name (required, ≤ 100 chars, unique).
  • color (optional, nullable): hex colour such as #3B82F6.

Returns 201 with the label. The creation is logged in the advertising activity log.

Requires the advertising.manage permission.

Also requires the advertising-manager feature (Advertising Manager plan); without it the endpoint returns 404.

Request​

Responses​

Created

Response Headers
    Content-Type