List connected social accounts

Retrieve all social accounts connected to your organization. This endpoint returns all social media profiles that have been connected and authorized through OAuth flows.

Use Cases:

View all connected social media accounts for your organization
Check which platforms have accounts connected
Verify account status and metadata
Get account information for use in post creation endpoints
Filter accounts by tenant ID, network, username, or unique platform ID

Filtering:

id - Filter by encoded social account ID (exact match)
tenantId - Filter by tenant ID for multi-tenant applications (exact match)
network - Filter by social network platform, e.g. x, linkedin, instagram (exact match)
networkUniqueId - Filter by the account's unique ID on the platform (exact match)
username - Filter by username or handle (case-insensitive partial match)
All filters can be combined for precise queries

Pagination:

Use limit and offset query parameters to paginate results
Default limit is 50, maximum is 100

Security: Sensitive OAuth tokens stored in network_data are never exposed in API responses. Only account metadata and identifiers are returned.

GET/v1/social-accounts

Query Parameters

id?string

Filter by social account ID (exact match, encoded ID as returned by the API)

tenantId?string

Filter by tenant ID (exact match)

network?string

Filter by social network platform (exact match, e.g. 'x', 'linkedin', 'instagram', 'threads', 'bluesky', 'facebook', 'tiktok', 'youtube', 'pinterest')

networkUniqueId?string

Filter by the account's unique identifier on the social network platform (exact match)

username?string

Filter by username or handle (case-insensitive partial match)

limit?number

Maximum number of results to return (1-100)

Default50

Range1 <= value <= 100

offset?number

Number of results to skip for pagination

Default0

Range0 <= value

Response Body

200application/json

400application/json

500application/json

JavaScript

Java

cURL

TypeScript

Python

Swift

fetch(" {
  method: "GET"
})

200400500

{
  "success": true,
  "data": [\
    {\
      "id": "9dyJS",\
      "orgId": "org_abc123",\
      "nickname": "My Company Twitter",\
      "network": "x",\
      "username": "@mycompany",\
      "profile_picture_url": "
      "network_unique_id": "123456789",\
      "customer_social_network_id": 5,\
      "accountType": "organization",\
      "isActive": 1,\
      "createdAt": "2025-01-15T10:30:00Z"\
    }\
  ],
  "count": 3,
  "limit": 50,
  "offset": 0
}

{
  "success": false,
  "error": "Session expired or invalid"
}

{
  "success": false,
  "error": "Internal server error",
  "message": "Database connection failed"
}

Delete media file DELETE\ \ Previous Page Get social network authentication URL POST\ \ Next Page

List connected social accounts ​

Query Parameters ​

Response Body ​

200application/json ​