Integrations — Wahlu API Docs

Integrations represent connected social media platforms for a brand. Integrations are managed through the Wahlu dashboard — the API provides read-only access.

Required scope: integrations:read

List integrations

GET/v1/brands/:brand_id/integrations

Returns all connected integrations for a brand.

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/integrations \
  -H "Authorization: Bearer wahlu_live_your_api_key_here"

Response

{
  "success": true,
  "data": [
    {
      "id": "int_instagram_123",
      "platform": "instagram",
      "status": "connected",
      "brand_id": "brand_abc123",
      "display_name": "Acme Co",
      "username": "@acmeco",
      "avatar_url": "https://scontent.cdninstagram.com/...",
      "permissions": null,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": "int_linkedin_456",
      "platform": "linkedin",
      "status": "connected",
      "brand_id": "brand_abc123",
      "display_name": "Acme Co",
      "username": "acme-co",
      "avatar_url": "https://media.licdn.com/...",
      "permissions": null,
      "created_at": "2026-01-15T10:35:00Z",
      "updated_at": "2026-01-15T10:35:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "has_more": false
  }
}

Response fields

Parameter	Type	Description
`id`	string	Unique integration identifier.
`platform`	string	Platform name (instagram, tiktok, youtube, facebook, linkedin).
`status`	string	Connection status (e.g. connected, expired).
`brand_id`	string	Brand this integration belongs to.
`display_name`	string \| null	Account display name on the platform.
`username`	string \| null	Account username or handle.
`avatar_url`	string \| null	Profile avatar URL.
`permissions`	object \| null	Platform-specific permission details.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-updated timestamp.

Get an integration

GET/v1/brands/:brand_id/integrations/:integration_id

Returns details for a single integration.

curl

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

Supported platforms

Parameter	Type	Description
`instagram`	platform	Instagram (business accounts)
`tiktok`	platform	TikTok (business accounts)
`youtube`	platform	YouTube channels
`facebook`	platform	Facebook Pages
`linkedin`	platform	LinkedIn (personal and company pages)