---
title: "GET social media profiles"
method: GET
path: "/social/profiles"
tags: ["Social"]
---

# GET social media profiles

`GET /social/profiles`

Retrieves all social media profiles connected to the account. A profile represents a single account on a social network (such as a Facebook Business Page, a LinkedIn Company Page, or an Instagram Business account) that the user has connected to Constant Contact.

Use the `include=accessible` query parameter to additionally check whether each profile is currently accessible for posting. Profiles that are not currently accessible will fail if used to publish a post.

## Query parameters

- `include` string[]

## Response `200`

Request successful

- ProfileDto[]
  - `accessible` boolean — Whether the profile is currently accessible for posting. Publishing a post will fail if its profile is not currently accessible. Only populated when the GET request includes the query parameter <code>include=accessible</code>.
  - `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.
  - `connected` boolean, required — Whether this profile is currently connected. You can only create and publish posts with connected profiles.
  - `handle` string — The profile's handle on the social network (for example, an Instagram or TikTok username). May be <code>null</code> if the network does not expose a separate handle (for example, Facebook).
  - `image_url` string — URL of the profile's image or avatar.
  - `name` string — Display name of the profile.
  - `network` string, required — The social network this profile belongs to.
  - `network_profile_id` string — The social network-specific identifier for this profile.
  - `network_user_id` string — The social network-specific identifier for the user who owns this profile.
  - `profile_id` string, required — Unique identifier for this profile. Use this value in the <code>profile_id</code> field of a <code>ProfilePost</code> when creating a post.
  - `settings` object — Network-specific settings for the profile. Only populated when the request includes <code>include=accessible</code> and settings are available for the network. Currently, only TikTok provides settings: <pre>"content": { "comment_disabled": Boolean, "duet_disabled": Boolean, "stitch_disabled": Boolean, "max_video_post_duration_sec": Integer }</pre>
  - `url` string — URL to the profile on the social 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/versions/4b4a534c818d/schema)