Docs / API / List channels

List channels

What this website can publish to, whether each channel is actually ready, and what kind of post it accepts.

3 min read All plans

GET /api/v1/channels

Ask this before you plan anything. It answers three things you cannot guess from outside, and getting any of them wrong means a week of posts that quietly never go out.

START HERE Connected is not the same as ready. Facebook and Pinterest can be connected and still unable to publish until a Page or board is chosen. Check ready.

website_id string REQUIRED

Which of your websites. Not needed if your key is narrowed to one.

FIELDWHAT IT TELLS YOUWHY IT MATTERS

connected An account is attached. A post planned for a channel with no account is never written.

ready Connected and able to publish now. Facebook and Pinterest also need a Page or board.

accepts Video, image, text — which this network takes. Instagram, TikTok and Pinterest have no text posts at all.

needs_media The channel cannot publish words alone. Send an image prompt, or the post is refused.

linkless This network strips links out. A URL in an Instagram caption does nothing.

account Which account, in words. Says "Reconnect this channel to publish" when a connection has lapsed.

The nine channel names are instagram, facebook, tiktok, youtube, linkedin, x, threads, pinterest and google_business.

GOOD TO KNOW Connecting a channel is not something this API does — it ends on the network's own consent screen, so it happens in your browser under Integrations.

CURL

curl "https://console.quqi.io/api/v1/channels?website_id=019feda8-0ca6-70d1-b927-697fa6650cda" \
  -H "Authorization: Bearer quqi_YOUR_KEY"

RESPONSE

{
  "success": true,
  "data": {
    "channels": [
      {
        "channel": "instagram",
        "label": "Instagram",
        "connected": true,
        "ready": true,
        "accepts": ["video", "image"],
        "needs_media": true,
        "linkless": true,
        "account": "Corner Bakery"
      }
    ],
    "connected_count": 1,
    "ready_count": 1
  }
}

Did this page answer your question? Yes Not quite

Issue a narrowed key

One channel