Social0|Docs
Integrations

REST API — Accounts

List and manage connected social accounts via the Social0 REST API.

List accounts

GET /v1/accounts
Authorization: Bearer sk_live_your_key

Response:

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "platform": "linkedin",
      "username": "jane",
      "profile_image_url": "https://...",
      "is_active": true,
      "token_expires_at": "2026-08-01T00:00:00.000Z",
      "token_status": "ok",
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Use id values in the platforms array when posting. MCP accepts platform names (linkedin) when only one account exists per platform.

Connect account (optional)

POST /v1/accounts/connect
Content-Type: application/json

{ "platform": "linkedin" }

Returns { "authorization_url": "https://..." } — user must complete OAuth in a browser. Recommended: connect in Dashboard → Connections instead.

Twitter/X and Bluesky: dashboard only.

Disconnect

DELETE /v1/accounts/:id

Returns 204 on success.

MCP tool

list_accountsGET /v1/accounts

Full documentation

Accounts reference · Connect accounts guide

On this page