---
title: "GET social network connections"
method: GET
path: "/social/connections"
tags: ["Social"]
---

# GET social network connections

`GET /social/connections`

Retrieves all social network accounts connected to the Constant Contact account, with support for multiple accounts per social network.

A connection represents the authorization link between a Constant Contact account and a single account on a social network (Facebook, Instagram, LinkedIn, TikTok, etc.). Each connection includes account information about the connected user on that network (display name, username, image, etc.) and the current status of the connection (whether it's active, rate-limited, or has any errors).

Note that a single connection may have multiple profiles (pages) associated with it — use `GET /social/profiles` to retrieve the individual profiles.

## Response `200`

Request successful

- ConnectionResponseDto — A wrapper containing the list of established social network connections for a given Constant Contact account.
  - `connections` ConnectionDto[] — List of established social network connections for the account.
    - `account_info` AccountInfoDto — Account information for a connected social network user.
      - `account_url` string — The account URL of the connected user's profile. Note: Facebook & Instagram do not support this.
      - `display_name` string — Display name of the connected user.
      - `image_url` string — URL of the connected user's avatar or image.
      - `network` string — The social network this account belongs to.
      - `network_account_id` string — The user identifier on the given network. Note: this is the network <em>account</em> id, not the <em>profile</em> id.
      - `username` string — Username of the connected user on the social network.
    - `connection_status` ConnectionStatusDto — Data indicating the status of a social network connection's integration.
      - `error` string — A message indicating that there was an unexpected error accessing the social network account.
      - `has_token` boolean — <code>true</code> if the integration has an authorization token for this social network account.
      - `is_active_user` boolean — A user is considered active if the user has any connected profiles for the social network account.
      - `rate_limited` boolean — Whether this social network account or the Constant Contact application is currently rate-limited by the social network provider.
      - `status` integer — The status returned from the given network's API when retrieving the account. This is typically only set when <code>error</code> is set.
      - `token_has_scopes` boolean — Whether the token associated with this user's social account integration has the scopes necessary to use Constant Contact social functionality.
      - `token_is_valid` boolean — <code>true</code> if the token for this social network is currently valid and can be successfully used to fetch data from the network.

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `500` — There was a problem with our internal service.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/revisions/4b4a534c818d/schema)