---
title: "List connected social accounts"
method: GET
path: "/api/social-accounts"
tags: ["Accounts"]
---

# List connected social accounts

`GET /api/social-accounts`

## Request

- Base URL: `https://api.dunsocial.com`
- URL: `https://api.dunsocial.com/api/social-accounts`
- Auth: HTTP bearer

## Headers

- `X-Workspace-Id` string, required

## Response `200`

Accounts (OAuth tokens omitted)

- object
  - `success` true, required
  - `data` SocialAccount[]
    - `id` string, required
    - `providerId` string
    - `providerName` string, required: Provider display name (for example X, Linkedin, Facebook). Facebook is a Page you manage, not a personal profile.
    - `username` string, nullable
    - `displayName` string, nullable
    - `profileImageUrl` string, nullable
    - `isConnected` boolean
    - `needsReconnect` boolean

## Other responses

- `401`: Missing or invalid bearer token
- `402`: Workspace is not on a paid plan
- `403`: Wrong workspace, missing scope, or role

---

[API](https://skmtc.dev/dunsocial/apis/dunsocial-api.md) · [All operations](https://skmtc.dev/dunsocial/apis/dunsocial-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dunsocial/apis/dunsocial-api/revisions/3c586d59e76f?raw)