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

fetch("https://api.outstand.so/v1/social-accounts?id=9dyJS&tenantId=tenant_123&network=x&networkUniqueId=123456789&username=mycompany&limit=50&offset=0", {  method: "GET"})
{
  "success": true,
  "data": [
    {
      "id": "9dyJS",
      "orgId": "org_abc123",
      "nickname": "My Company Twitter",
      "network": "x",
      "username": "@mycompany",
      "profile_picture_url": "https://example.com/profile.jpg",
      "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"
}