---
title: "List connected social accounts"
method: POST
path: "/api/social/accounts"
tags: ["Social"]
---

# List connected social accounts

`POST /api/social/accounts`

## Request

- Base URL: `https://app.pedra.ai`
- URL: `https://app.pedra.ai/api/social/accounts`
- Auth: none required

Returns every supported network and whether it's connected for this Pedra user. `account` is the Instagram/TikTok username or the Facebook Page name; YouTube doesn't share the channel name, so it's always null. Accounts are connected in the app under Settings › Socials, not via the API. Pedra Pro only. Free.

## Request body

- object
  - `apiKey` string, required: Account API key, sent in the request body. Get one at https://app.pedra.ai under Settings → API.

## Response `200`

Every supported network.

- object
  - `accounts` object[]
    - `network` 'instagram' | 'facebook' | 'tiktok' | 'youtube', required: A supported social network.
    - `connected` boolean, required
    - `account` string, nullable, required: Username or Page name; always null for YouTube.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The account isn't on Pedra Pro.
- `405`: Wrong HTTP method; these endpoints accept POST only.
- `500`: Unexpected server error.

---

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