Skip to content

List brands

GET /public/v1/groups

Returns the brands in your organization, the same ones the app lists under Brands. A brand collects the channels that belong to one client or one business, which is how agencies keep several accounts apart in the same organization.

Doing this in the app? See Brands. Also available as sharek integrations:groups (CLI) and groupList (MCP).

Takes no parameters.

Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/groups
[
{ "id": "group-id", "name": "Acme Corp" },
{ "id": "another-group-id", "name": "Globex" }
]
Field Description
id The brand id. Pass it as group to list channels or as customer to list posts.
name The brand name as it appears in Sharek.

An organization with no brands gets [].

  • List channels with ?group= to get one brand’s channels.
  • List posts with ?customer= to get one brand’s scheduled posts.