Misar IO Docs

Connections

List connected social accounts and manage OAuth connections in MisarSocial.

List Connected Accounts

GET /api/connections

Returns all active social media accounts connected by the authenticated user.

Response

{
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "platform": "twitter",
      "display_name": "@yourhandle",
      "avatar_url": "https://pbs.twimg.com/profile_images/...",
      "status": "active"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "platform": "linkedin",
      "display_name": "Your Name",
      "avatar_url": "https://media.licdn.com/...",
      "status": "active"
    }
  ]
}
accountsarray

List of active connected accounts. Only accounts with status: "active" are returned.

accounts[].idstring

UUID. Use this as connectedAccountId when scheduling posts.

accounts[].platformstring

Platform identifier: twitter, linkedin, instagram, threads, tiktok, bluesky.

accounts[].statusstring

Always "active" in this response. Expired or revoked accounts are excluded.


Connect an Account

Account connections are initiated from the MisarSocial dashboard UI via OAuth — they are not available via the REST API. Navigate to Dashboard → Settings → Connected Accounts and click Connect next to your platform.

OAuth entry points (browser only)

PlatformOAuth start URL
Twitter/X/api/auth/twitter
LinkedIn/api/auth/linkedin
Instagram/api/auth/instagram
Threads/api/auth/threads
TikTok/api/auth/tiktok
Bluesky/api/auth/bluesky

These OAuth endpoints require a browser session — they are not callable from server-side API clients.


Disconnect an Account

POST /api/auth/disconnect

Disconnects a previously connected social account.

Body

accountIdstringrequired

UUID of the connected account to disconnect.

Response

{ "ok": true }

Disconnecting an account cancels all queued posts for that account that have not yet been published.