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

# List social accounts

`GET /social-accounts`

## Request

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

Returns social accounts that can currently be used for publishing.

When `projectId` is provided, only social accounts usable within that project are returned.

## Query parameters

- `projectId` string

## Response `200`

Social accounts.

- SocialAccount[]
  - `externalAccountId` string, required: Platform-specific account, page, profile, or channel identifier.
  - `id` string, required: Social account identifier.
  - `imageUrl` string, uri, required: Profile image URL for the connected account.
  - `platform` 'PINTEREST' | 'LINKEDIN' | 'LINKEDIN_PAGES' | 'INSTAGRAM' | 'FACEBOOK' | 'THREADS' | 'TIKTOK' | 'X' | 'YOUTUBE' | 'WOOPTEST', required: Identifies which social media platform this data structure targets.
  - `status` 'CONNECTED' | 'DISCONNECTED', required
  - `username` string, required: Display name or username for the connected account.

## Other responses

- `429`: Too many requests are already in progress for this API key.

---

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