Social Accounts endpoints

Connected accounts are the targets you pass into social_accounts when creating posts. Only active accounts for the current workspace are returned.

Endpoints

• GET /api/v1/social-accounts — List accounts with platform/username filters.
• GET /api/v1/social-accounts/{id} — Fetch a single account.

GET /api/v1/social-accounts

Query filters:

• offset, limit — see pagination rules.
• platform — array of platform IDs (twitter-x, instagram, linkedin, facebook-page, tiktok, youtube, bluesky, threads, pinterest).
• username — array; performs case-insensitive contains search.

Response:

{
  "data": [
    {
      "id": "acc-123",
      "platform": "linkedin",
      "username": "syncpostly",
      "display_name": "SyncPostly Marketing"
    }
  ],
  "meta": { "offset": 0, "limit": 10, "total": 3 }
}

Example:

curl "https://<host>/api/v1/social-accounts?platform=linkedin&username=social" \
  -H "Authorization: Bearer YOUR_SECRET_TOKEN"

GET /api/v1/social-accounts/{id}

Path: id (string). Returns a single account object; 404 if not found or not owned by the workspace.

Notes

• Only accounts with status active are returned; paused/revoked tokens are hidden from results.
• Use the returned id list directly in the Posts API; there is no separate platform-specific ID mapping required.