Endpoint

Connected accounts

Use this endpoint to discover which social accounts a workspace can publish to. Account ids returned here are the ids you pass to social_account_ids when creating, scheduling, or publishing a post.

List connected accounts

GET /api/v1/social-accounts returns a token-safe summary of every account connected to the workspace. It never includes access tokens, refresh tokens, or any other secret material.

Connected accounts are added through the dashboard's Connect account flow, not through the public API. The public API is intentionally read-only here so it cannot be used to smuggle a new social account into a workspace.

curl "$SOCIALSPOOL_BASE_URL/api/v1/social-accounts" \
  -H "Authorization: Bearer $SOCIALSPOOL_API_KEY"

Successful response shape:

{
  "results": [
    {
      "id": "acct_01HZ...",
      "platform": "x",
      "username": "acme",
      "display_name": "Acme",
      "status": "connected"
    }
  ],
  "count": 1
}
Response fields
  • id: opaque account id. Pass this to social_account_ids on write endpoints.
  • platform: one of x, linkedin, bluesky, facebook, threads, instagram, tiktok, youtube.
  • username: the platform-side handle for the account.
  • display_name: the user-facing display name, if the platform provides one.
  • status: connected, disconnected, or error. The public API only returns connected accounts in the list.