Docs home
ChannelDesk docs

Brands and connections

Select a brand and discover its available publishing context.


Brands and connections

  • GET /api/v1/brands lists brands available to the authenticated user.
  • GET /api/v1/brands/{id} returns one accessible brand and its details.

Use the selected ID as brand_id in content, media, and template requests.

List available brands

GET /api/v1/brands returns a brands array. Every brand contains its available social_networks.

Select publishing targets

social_networks[].id is the network_connection_id required by PUT /api/v1/contents/{id}/social-posts. Do not use social_network_id or provider_id in its place.

  • Show only records with connected=true as publishable.
  • Enable formats using post, reel, story, and short capability flags.
  • Use default_selected only as an initial UI suggestion.
  • Reload brands after OAuth reconnect because connections and capabilities may change.

Load one brand

GET /api/v1/brands/{id} returns one brand without the outer array. Treat 404 as unavailable access and return to brand selection.