Brands — Wahlu API Docs

Brands represent your social media identities. Each brand can have multiple connected platforms (integrations). Most API endpoints require a brand_id to scope operations.

Required scope: brands:read

List brands

GET/v1/brands

Returns all brands in your workspace.

Query parameters

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

Example

curl

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

Response

{
  "success": true,
  "data": [
    {
      "id": "brand_abc123",
      "name": "Acme Co",
      "description": "Social media agency",
      "logo_url": "https://storage.wahlu.com/logos/acme.png",
      "logo_light_url": null,
      "logo_dark_url": null,
      "timezone": "Europe/London",
      "website": "https://acme.co",
      "business_category": "Marketing",
      "brand_kit": null,
      "content_preferences": {
        "default_cta": "Visit acme.co",
        "logo_frequency": "always",
        "cta_frequency": "sometimes"
      },
      "image_posting": null,
      "video_posting": null,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-02-01T14:20:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "has_more": false
  }
}

Get a brand

GET/v1/brands/:brand_id

Returns a single brand by ID.

curl

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

Response

{
  "success": true,
  "data": {
    "id": "brand_abc123",
    "name": "Acme Co",
    "description": "Social media agency",
    "logo_url": "https://storage.wahlu.com/logos/acme.png",
    "logo_light_url": null,
    "logo_dark_url": null,
    "timezone": "Europe/London",
    "website": "https://acme.co",
    "business_category": "Marketing",
    "brand_kit": null,
    "content_preferences": {
      "default_cta": "Visit acme.co",
      "logo_frequency": "always",
      "cta_frequency": "sometimes"
    },
    "image_posting": null,
    "video_posting": null,
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-02-01T14:20:00Z"
  }
}

Response fields

Parameter	Type	Description
`id`	string	Unique brand identifier.
`name`	string	Brand display name.
`description`	string \| null	Brand description.
`logo_url`	string \| null	Primary logo URL.
`logo_light_url`	string \| null	Logo for light backgrounds.
`logo_dark_url`	string \| null	Logo for dark backgrounds.
`timezone`	string \| null	IANA timezone (e.g. Europe/London).
`website`	string \| null	Brand website URL.
`business_category`	string \| null	Business category.
`brand_kit`	object \| null	Brand colours, fonts, and style guidelines.
`content_preferences`	object \| null	Content defaults (default_cta, logo_frequency, cta_frequency).
`image_posting`	string \| null	Image posting preference.
`video_posting`	string \| null	Video posting preference.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-updated timestamp.