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 by tenant ID to list accounts for a specific end-user

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

tenantId?string

Filter by tenant ID (exact 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

curl -X GET "https://api.outstand.so/v1/social-accounts?tenantId=tenant_123&limit=50&offset=0"
{
  "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": "Internal server error",
  "message": "Database connection failed"
}