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