---
title: "Retrieve social profiles"
method: GET
path: "/v1/socialProfiles"
tags: ["Social Profiles"]
---

# Retrieve social profiles

`GET /v1/socialProfiles`

## Request

- Base URL: `https://platform.hootsuite.com`
- URL: `https://platform.hootsuite.com/v1/socialProfiles`
- Auth: OAuth 2
  - Authorization code: `https://platform.hootsuite.com/oauth2/auth`
  - Token URL: `https://platform.hootsuite.com/oauth2/token`

Retrieves the social profiles that the authenticated user has access to.

## Headers

- `Authorization` string, required

## Response `200`

Success

- SocialProfilesResponseEnvelope: The response data wrapper for a social profile.
  - `data` SocialProfile[]
    - `id` string: The social profile ID.
    - `type` 'FACEBOOK' | 'FACEBOOKPAGE' | 'INSTAGRAM' | 'INSTAGRAMBUSINESS' | 'LINKEDIN' | 'LINKEDINCOMPANY' | 'PINTEREST' | 'THREADS' | 'TIKTOKBUSINESS' | 'TWITTER' | 'WHATSAPP' | 'YOUTUBECHANNEL': The social network the profile belongs to.
    - `socialNetworkId` string: The ID for user on the social network.
    - `socialNetworkUsername` string: The username used on the social network. This field will be **null** if the social network type is *TWITTER*.
    - `avatarUrl` string: Link to the avatar used by user on the social network (if present). This field will be **null** if the social network type is *TWITTER*.
    - `owner` 'MEMBER' | 'ORGANIZATION': Key representing who owns this profile the member or the organization the member is a part of.
    - `ownerId` string: The owner ID. Either a member ID or an organization ID.
    - `isReauthRequired` integer: 1 indicates that this social profile is disconnected and needs to be reconnected, 0 shows the social profile is in a connected state.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api.md) - [All operations](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hootsuite/apis/hootsuite-rest-api/revisions/adac53bd28bb?raw)
