---
title: "List connected social media channels"
method: GET
path: "/channels"
tags: ["Publishing"]
---

# List connected social media channels

`GET /channels`

Returns all connected social media channels (YouTube, TikTok, Instagram, Facebook, Threads, and X) for your organization.

**Note:** Channels must be connected via the AITuber dashboard (OAuth flow). This endpoint is read-only; use it to discover channel IDs for publishing.

**After listing channels:**
Use the channel `id` values when calling `POST /publications` to publish a video.

## Query parameters

- `platform` 'youtube' | 'tiktok' | 'instagram' | 'facebook' | 'threads' | 'x' | 'all' — Filter by platform. Use "all" or omit to list all connected channels.

## Response `200`

OK

- object[]
  - `id` string, uuid, required — Channel ID. Use this when publishing.
  - `platform` 'youtube' | 'tiktok' | 'instagram' | 'facebook' | 'threads' | 'x', required — Social media platform.
  - `platformChannelId` string, required — Platform-specific channel/account ID.
  - `channelName` string, required — Display name of the channel or account.
  - `channelUsername` string, nullable, required — Username or handle (e.g. @username).
  - `channelThumbnailUrl` string, nullable, required — Profile picture URL.
  - `subscriberCount` number, nullable, required — Subscriber/follower count. May be null for non-YouTube platforms.
  - `status` 'connected' | 'disconnected' | 'token_expired', required — Connection status. - `connected`: Ready to publish. - `disconnected`: Channel was disconnected. Reconnect via dashboard. - `token_expired`: OAuth token expired. Reconnect via dashboard.
  - `connectionProvider` 'direct' | 'managed', required — How this channel is connected. `direct` = connected with a Google account (legacy YouTube). `managed` = connected through AITuber managed publishing (current default for all platforms).
  - `lastSyncedAt` string, date-time, nullable, required — When channel data was last refreshed from the platform.
  - `createdAt` string, date-time, required — When this connection was created or last migrated.

## Other responses

- `401` — 401
- `402` — 402
- `403` — 403

---

[API](https://skmtc.net/aituber/apis/aituber-api.md) · [All operations](https://skmtc.net/aituber/apis/aituber-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aituber/aituber-api/revisions/35448566f143/schema)