Skip to content

List channels

GET /public/v1/integrations

Returns every channel connected to your organization. This is where integration ids come from, so most clients call it first and cache the result.

Doing this in the app? See connecting your channels. Also available as sharek integrations:list (CLI) and integrationList (MCP).

Parameter Required Description
group No A brand id from list brands. Returns only channels assigned to that brand.
Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/integrations

Filtered to one brand:

Terminal window
curl -H "Authorization: your-api-key" \
"https://dash.sharek.app/api/public/v1/integrations?group=group-id"

An array, not an envelope:

[
{
"id": "channel-id",
"name": "Sharek on X",
"identifier": "x",
"picture": "https://example.com/avatar.png",
"disabled": false,
"profile": "sharekapp",
"customer": { "id": "group-id", "name": "Acme Corp" }
}
]
Field Description
id The integration id. This is what every other operation means by “channel”.
name The name you gave the channel in Sharek, or the account’s name on the platform if you never renamed it. List posts always returns the name from the platform, so the two can differ.
identifier The provider, for example x, linkedin, instagram. This is the value that goes in a post’s settings.__type.
picture Avatar URL, or null.
disabled true when the channel is switched off. A disabled channel will not publish.
profile The account handle on the platform, where the provider exposes one.
customer The brand this channel belongs to, or absent when it belongs to none.
  • Deleted channels are excluded. Disabled ones are included with disabled: true, so filter on that yourself if you only want publishable channels.
  • The identifier values here are exactly the slugs in the channels Sharek offers, which links every channel’s settings page.
  • The API calls brands group in this query, groups in the path, and customer in fields. They are the same thing, and the app calls them brands.
  • An unknown group value is not an error. It simply matches nothing and returns [].