Accounts

List accounts

Changed on Oct 22, 2026

Lists the social accounts connected to the workspace of this API key, one entry per channel. Requires the accounts:read scope.

get/accounts

Request

Base URL
https://api.omnisocials.com/v1
URL
https://api.omnisocials.com/v1/accounts
Auth
HTTP bearer

Query parameters

Filter by platform

Response

List of connected accounts

workspace_idinteger

Stable id of the active workspace this key belongs to.

workspace_namestring nullable

Human-readable name of the active workspace.

workspace_iconstring nullable

Example response

{
  "data": [
    {
      "id": "1234_instagram",
      "username": "yourbrand",
      "display_name": "Your Brand",
      "profile_picture": "https://example.com/avatar.jpg",
      "reauth_reason": "OAuthException: Session has expired",
      "boards": [
        {
          "id": "1234567890123456789",
          "name": "Recipes"
        }
      ],
      "platform_details": {
        "subscription_type": "Premium",
        "chat_id": "-1001234567890",
        "subscribers": 1250,
        "url": "https://t.me/brand",
        "guild_id": "1180000000000000000",
        "guild_name": "Brand Community",
        "channel_id": "1180000000000000001",
        "channel_name": "announcements",
        "webhook_name": "OmniSocials"
      },
      "connected_at": "2026-03-02T10:15:00.000Z"
    }
  ],
  "workspace_id": 1234,
  "workspace_name": "Daily Edge Sports"
}

Changes

Oct 22, 20261e06adee390e Revision changes
- breaking
  the response property // became nullable for the status
- warning
  added the new discord enum value to the // response property for the response status
- info
  added the new enum value discord to the query request parameter platform
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
Oct 17, 20264595e0af81de Revision changes
- warning
  added the new telegram enum value to the // response property for the response status
- info
  added the new enum value telegram to the query request parameter platform
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status

Operation history