Labels — Wahlu API Docs

Labels help you organise posts, media, and ideas into categories. You can filter content by label across the API.

List labels

GET/v1/brands/:brand_id/labels

Returns all labels for a brand. Requires labels:read.

Query parameters

Parameter	Type	Description
`page`	integer	Page number. Defaults to 1.
`limit`	integer	Items per page. Defaults to 50, max 100.

curl

curl https://api.wahlu.com/v1/brands/brand_abc123/labels \
  -H "Authorization: Bearer wahlu_live_your_api_key_here"

Response

{
  "success": true,
  "data": [
    {
      "id": "label_promo",
      "name": "Promotions",
      "color": "#E97451",
      "created_at": "2026-01-15T10:00:00Z",
      "updated_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": "label_content",
      "name": "Content",
      "color": "#3EB9EA",
      "created_at": "2026-01-15T10:00:00Z",
      "updated_at": "2026-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "has_more": false
  }
}

Response fields

Parameter	Type	Description
`id`	string	Unique label identifier.
`name`	string	Label display name.
`color`	string \| null	Hex colour code (e.g. #E97451).
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-updated timestamp.

Create a label

POST/v1/brands/:brand_id/labels

Creates a new label. Requires labels:write.

Request body

Parameter	Type	Description
`name`*	string	The label name. Max 100 characters.
`color`	string	Hex colour code (e.g. #E97451). Max 20 characters.

curl

curl -X POST https://api.wahlu.com/v1/brands/brand_abc123/labels \
  -H "Authorization: Bearer wahlu_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Updates",
    "color": "#22C55E"
  }'

Update a label

PATCH/v1/brands/:brand_id/labels/:label_id

Updates a label. Only provided fields are changed. Requires labels:write.

Request body

Parameter	Type	Description
`name`	string	Updated name. Max 100 characters.
`color`	string	Updated hex colour code. Max 20 characters.

Delete a label

DELETE/v1/brands/:brand_id/labels/:label_id

Deletes a label. Posts with this label are not deleted — the label is simply removed from them. Requires labels:write.