Sign in
Social Accounts

List Social Accounts

Lists the social accounts linked to an account or user.

get/social_accounts

Query parameters

account_idstring

The Account that the social accounts are connected to. Provide either this or user_id.

user_idstring

The User that the social accounts are connected to. Provide either this or account_id.

platform'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram'

Only return social accounts for the platform that is specified.

verifiedboolean

Only return social accounts that are verified on the platform.

scopesstring[]

Only return social accounts that have these scopes.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

order'display_order' | 'created_at'

The field to sort social accounts by.

direction'asc' | 'desc'

Sort direction.

Response

filtered to accounts holding the requested scope

Example response

{
  "data": [
    {
      "error": "You don't have permission to share this account. Ask an admin of its Meta Business Portfolio to grant you full control, then share it again.",
      "external_id": "1234567891",
      "id": "sacc_xxxxxxxxxxxxxx",
      "name": "Shine Time Auto Detailing",
      "parent_social_account": {
        "external_id": "555111",
        "id": "sacc_xxxxxxxxxxxxxx",
        "name": "Shine Time Auto Detailing",
        "platform": "facebook",
        "profile_picture_url": "https://shinetime.example/logo.png",
        "username": "shinetimedetailing",
        "verified": true
      },
      "platform": "instagram",
      "profile_picture_url": "https://shinetime.example/logo.png",
      "scopes": [
        "advertise"
      ],
      "url": "https://instagram.com/shinetimedetail",
      "username": "shinetimedetail",
      "verified": true
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes