Social Accounts

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
  • total is the number of accounts matching your filters across all pages; count is the number returned in this page
  • Results are always ordered by connection order (oldest connected first), so paging through every offset returns each account exactly once. Accounts connected while you are paginating are appended after the last page rather than shifting the pages you already fetched

Tokens: By default, OAuth tokens are never exposed. Pass includeTokens=true to include the account's access_token nested under a tokens object in each result. Only access_token is returned - refresh tokens and other sensitive fields remain hidden.

get/v1/social-accounts

Request

  • Base URL: https://api.outstand.so
  • URL: https://api.outstand.so/v1/social-accounts
  • Auth: none declared

Query parameters

idstring
Example:9dyJS

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

tenantIdstring
Example:tenant_123

Filter by tenant ID (exact match)

networkstring
Example:x

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

networkUniqueIdstring
Example:123456789

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

usernamestring
Example:mycompany

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

limitnumber
Example:50

Maximum number of results to return (1-100)

offsetnumber

Number of results to skip for pagination

includeTokens'true' | 'false'
Example:false

When true, include the account's access_token (from network_data) under a tokens object in each result. Defaults to false; tokens are never returned otherwise.

Response

List of social accounts retrieved successfully

successboolean required
countnumber required

Number of social accounts returned in this page

totalnumber required

Total number of social accounts matching the filters, across all pages

limitnumber required

Maximum number of results per page

offsetnumber required

Number of results to skip

Example response

{
  "success": true,
  "data": [
    {
      "id": "9dyJS",
      "orgId": "org_abc123",
      "tenant_id": "tenant_123",
      "nickname": "My Company Twitter",
      "network": "x",
      "username": "@mycompany",
      "profile_picture_url": "https://example.com/profile.jpg",
      "network_unique_id": "123456789",
      "network_webhook_reference_id": "17841469709963147",
      "customer_social_network_id": 5,
      "accountType": "organization",
      "isActive": 1,
      "createdAt": "2025-01-15T10:30:00Z",
      "tokens": {
        "access_token": "ya29.a0Af..."
      }
    }
  ],
  "count": 3,
  "total": 292,
  "limit": 50
}

Changes

No recorded changes to this operation across all 1 revision of this API.