Accounts

Retrieve your connected social media accounts. Use account IDs when creating posts to specify which accounts to publish to. A workspace can hold several accounts of one platform, each with its own ID.

List Accounts

Returns all active connected social media accounts for the workspace. Inactive (revoked / disconnected) accounts are filtered out. Paused accounts (past the owner's plan's channel count) are listed too; posting to one returns 400 CHANNEL_PAUSED.

GET/v1/accountsList connected social media accounts

Headers

Parameter	Type	Required	Description
`X-Workspace-Id`	string	Optional	Required when using an all-scope API key. The workspace whose accounts to list.

Example Request

List all connected accounts

curl https://api.quegly.com/v1/accounts \
  -H "Authorization: qgl_your_api_key"

Response

200 OK

{
  "accounts": [
    {
      "id": "acc-instagram-123",
      "platform": "instagram",
      "account_username": "mydesigncarousel",
      "display_name": "My Design Carousels",
      "profile_picture_url": "https://scontent.cdninstagram.com/avatar.jpg",
      "is_active": true
    },
    {
      "id": "acc-tiktok-456",
      "platform": "tiktok",
      "account_username": "mydesigncarousel",
      "display_name": "My Design Carousels",
      "profile_picture_url": "https://p16-sign.tiktokcdn.com/avatar.jpg",
      "is_active": true
    }
  ]
}

Response Fields

Parameter	Type	Required	Description
`id`	string	Required	Unique account ID. Use this in account_ids when creating posts.
`platform`	string	Required	Platform identifier: "instagram", "facebook", "youtube", "tiktok", "x", "threads", "linkedin", "bluesky", "pinterest", or "telegram"
`account_username`	string	Required	The handle, without the @, on "instagram", "x", "threads", "bluesky" and "pinterest". Elsewhere it is a name, so put no @ before it: a Facebook Page's name, a YouTube channel's title, a TikTok account's display name, a LinkedIn member's name, or a Telegram chat's title
`display_name`	string \| null	Required	Display name on the platform, or null where the platform gives none (use account_username then). For "telegram", the chat's public @username, or its title for a private chat
`profile_picture_url`	string	Required	Profile picture URL
`is_active`	boolean	Required	Always true on returned rows (inactive accounts are filtered out)

Connecting accounts

Social media accounts must be connected on the workspace's Manage page in the Quegly dashboard: via OAuth, or for Telegram by letting Quegly's bot into the channel or group. The API does not support connecting new accounts, since each connection needs the user in a browser (or in Telegram). Each connected account is one channel, and the owner's plan sets how many channels they can connect across all their workspaces. Once connected, you can use the account IDs returned here in all API calls.