List social accounts

curl -X GET https://app.trypost.it/api/social-accounts \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
    "platform": "linkedin",
    "display_name": "John Doe",
    "username": "johndoe",
    "is_active": true,
    "status": "connected"
  },
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "platform": "x",
    "display_name": "John",
    "username": "@johndoe",
    "is_active": true,
    "status": "connected"
  }
]

GET

social-accounts

curl -X GET https://app.trypost.it/api/social-accounts \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
    "platform": "linkedin",
    "display_name": "John Doe",
    "username": "johndoe",
    "is_active": true,
    "status": "connected"
  },
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "platform": "x",
    "display_name": "John",
    "username": "@johndoe",
    "is_active": true,
    "status": "connected"
  }
]

Response

Plain array of social account objects. Each item has these fields:

Read accounts by id, not by platform. A workspace holds one account per network, so each platform appears at most once — but that is a plan limit, not a guarantee of this endpoint.

Accounts are connected from the dashboard, since every platform needs a browser to authorize. The API reads them and can toggle one active or inactive; it cannot add or remove one.

string

Social account UUID.

string

Platform identifier. One of: linkedin, linkedin-page, x, facebook, instagram, instagram-facebook, tiktok, youtube, threads, pinterest, bluesky, mastodon, telegram, discord.

string

The account’s display name.

string

The account’s username or handle.

boolean

Whether the account is active for publishing. Toggle with PUT /social-accounts/{id}/toggle.

string

Connection status: connected, disconnected, or token_expired. Disconnected/expired accounts are skipped at publish time.

curl -X GET https://app.trypost.it/api/social-accounts \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
    "platform": "linkedin",
    "display_name": "John Doe",
    "username": "johndoe",
    "is_active": true,
    "status": "connected"
  },
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "platform": "x",
    "display_name": "John",
    "username": "@johndoe",
    "is_active": true,
    "status": "connected"
  }
]

Overview

Posts

Platforms

Workspace

Assets

Signatures

Labels

Social Accounts

API Keys

Webhooks

Response

​Response

Response