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

# List social accounts

`GET /social-accounts`

## Request

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

Returns all connected social accounts across all your workspaces.

## Response `200`

List of social accounts

- object
  - `ok` boolean
  - `data` SocialAccount[]
    - `id` string, uuid
    - `workspaceId` string, uuid
    - `platform` 'FACEBOOK' | 'INSTAGRAM' | 'X' | 'LINKEDIN' | 'TIKTOK' | 'YOUTUBE' | 'THREADS' | 'BLUESKY' | 'PINTEREST' | 'GOOGLE_BUSINESS'
    - `accountName` string
    - `accountUrl` string, nullable
    - `profilePictureUrl` string, nullable
    - `customLabel` string, nullable: User-set label to distinguish accounts (e.g. "Downtown")

---

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