Skip to main content
GET
List channels
The id of each channel is what Create a post, Get a channel’s settings, Trigger a tool and the analytics endpoints take. identifier names the network, such as bluesky or wordpress; the settings each network takes are on Posting settings by network. name is the channel’s name in PostQueen. When someone renamed the channel in the app, it is that name, and the account’s name on the network is not returned. Renaming is done in the app only: see Connect a channel. A channel with disabled: true is switched off in the app and does not publish until someone turns it back on.

Authorizations

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Query Parameters

group
string

Only channels assigned to this customer id (see List groups)

Response

The channels

id
string

The channel's id. Every other call that names a channel takes it

name
string

The channel's name in PostQueen: the name someone gave it with Rename channel in the app, or else the account's name on the network. The network's own name is not returned when the channel is renamed

identifier
enum<string>

Provider identifier

Available options:
bluesky,
devto,
discord,
dribbble,
facebook,
gmb,
hashnode,
instagram,
instagram-standalone,
kick,
lemmy,
linkedin,
linkedin-page,
listmonk,
mastodon,
mewe,
moltbook,
nostr,
pinterest,
reddit,
skool,
slack,
telegram,
threads,
tiktok,
tiktok-business,
tumblr,
twitch,
vk,
whop,
wordpress,
wrapcast,
x,
youtube
picture
string | null

Profile picture URL

disabled
boolean

True when the channel is switched off in the app. A disabled channel does not publish

profile
string | null

Profile handle or username

customer
object

The customer the channel is assigned to. Left out when there is none

Last modified on October 9, 2026