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' | 'linkedin' | 'snapchat'

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

Changed in 6 of the 74 revisions of this API.268

  • c1dceb26e50521See the full diff
    • ●

      added the new snapchat enum value to the /////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new snapchat enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value snapchat to the query request parameter platform

      request-parameter-enum-value-added

  • 7fcefabddb0a21See the full diff
    • ●

      added the new linkedin enum value to the /////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new linkedin enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value linkedin to the query request parameter platform

      request-parameter-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • a01100378e591See the full diff
    • ○

      added the required property // to the response with the status

      response-required-property-added

  • f1020c3ecda42See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 60bbb4a6ffbc23See the full diff
    • ●

      added the new discord enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new telegram enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value discord to the query request parameter platform

      request-parameter-enum-value-added

    • ○

      added the new enum value telegram to the query request parameter platform

      request-parameter-enum-value-added

    • ○

      added the required property // to the response with the status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 3a06a605784b2See the full diff
    • ▲

      the response property // became nullable for the status

      response-property-became-nullable

    • ▲

      the response property // became nullable for the status

      response-property-became-nullable

Of the 74 revisions, 1 has no diff computed.