Developers
Channels
A channel is one connected social account (a Facebook Page, an Instagram Business profile, a YouTube channel, a TikTok account, or a custom webhook). API keys can target any channel across any brand in the owning organization.
List channels
GET
/api/v1/channelscurl https://postme.live/api/v1/channels \
-H "Authorization: Bearer pml_live_..."Response — 200 OK
{
"data": [
{
"id": "5a1d…",
"platform": "meta_instagram",
"display_name": "@outbackyak",
"avatar_url": "https://…",
"status": "active",
"business_id": "9f3a…",
"business_name": "Outback Yak"
},
{
"id": "6b2e…",
"platform": "youtube",
"display_name": "Outback Yak",
"avatar_url": null,
"status": "active",
"business_id": "9f3a…",
"business_name": "Outback Yak"
}
]
}Status values
| Status | Meaning |
|---|---|
active | Tokens valid; the channel can publish. Only active channels are valid targets in POST /posts. |
expired | Refresh failed. The owning user must reconnect from the dashboard. |
revoked | Provider revoked the grant. Same fix as expired. |
disconnected | User disconnected the channel in-app. Reconnecting restores it. |