List channels
GET /public/v1/integrationsReturns 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).
Query parameters
Section titled “Query parameters”| Parameter | Required | Description |
|---|---|---|
group |
No | A brand id from list brands. Returns only channels assigned to that brand. |
Request
Section titled “Request”curl -H "Authorization: your-api-key" \ https://dash.sharek.app/api/public/v1/integrationsFiltered to one brand:
curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/integrations?group=group-id"Response
Section titled “Response”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
identifiervalues here are exactly the slugs in the channels Sharek offers, which links every channel’s settings page. - The API calls brands
groupin this query, groups in the path, andcustomerin fields. They are the same thing, and the app calls them brands. - An unknown
groupvalue is not an error. It simply matches nothing and returns[].