Providers

List connected social media accounts.

Postman CollectionDownload the ready-made collection with all endpoints pre-configured.

Use with Claude, ChatGPT & moreConnect any AI assistant to BlackTwist via our MCP server. No code required.

List Providers

Returns all connected social media accounts (Threads and Bluesky) for the authenticated user. If a teamId is provided, returns accounts linked to that team.

`GET /api/v1/providers`

Query Parameters:

teamId (optional) — Team ID. Omit for personal accounts.

Request

curl https://blacktwist.app/api/v1/providers?teamId=ws_abc123 \
  -H "Authorization: Bearer bt_api_..."

Response

{
  "providers": [
    {
      "id": "clx....",
      "provider": "THREADS",
      "providerUserId": "12345678",
      "providerUsername": "johndoe",
      "displayName": "John Doe",
      "profilePicture": "https://example.com/avatar.jpg",
      "createdAt": "2025-01-15T10:30:00.000Z"
    },
    {
      "id": "clx5jkl6mno7pqr8",
      "provider": "BLUESKY",
      "providerUserId": "did:plc:abc123",
      "providerUsername": "johndoe.bsky.social",
      "displayName": "John Doe",
      "profilePicture": null,
      "createdAt": "2025-02-01T08:00:00.000Z"
    }
  ]
}

Response Fields

id — Internal provider record ID. Use this as providerId in other endpoints.
provider — Platform type: THREADS or BLUESKY.
providerUserId — Your user ID on the social platform.
providerUsername — Your username on the social platform.
displayName — Your display name on the social platform.
profilePicture — URL to your profile picture, or null.
createdAt — When the account was connected.

Authentication

Posts