Sign in
latestOpenAPI 3.1.12026-08-22330162.7 KB

35448566f143

Publishing

List connected social media 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.

get/channels

Query parameters

platform'youtube' | 'tiktok' | 'instagram' | 'facebook' | 'threads' | 'x' | 'all'

Filter by platform. Use "all" or omit to list all connected channels.

Response

OK

idstring uuid required

Channel ID. Use this when publishing.

platform'youtube' | 'tiktok' | 'instagram' | 'facebook' | 'threads' | 'x' required

Social media platform.

platformChannelIdstring required

Platform-specific channel/account ID.

channelNamestring required

Display name of the channel or account.

channelUsernamestring nullable required

Username or handle (e.g. @username).

channelThumbnailUrlstring nullable required

Profile picture URL.

subscriberCountnumber 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).

lastSyncedAtstring date-time nullable required

When channel data was last refreshed from the platform.

createdAtstring date-time required

When this connection was created or last migrated.