---
title: "List connected social accounts"
method: GET
path: "/v1/accounts"
---

# List connected social accounts

`GET /v1/accounts`

## Request

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

Returns the connected accounts of the workspace. Use the returned ids as accountIds when creating posts.

## Query parameters

- `workspace` string

## Response `200`

OK

- object
  - `accounts` Account[], required
    - `id` string, required
    - `platform` 'instagram' | 'tiktok' | 'x' | 'reddit' | 'linkedin' | 'youtube' | 'facebook' | 'threads' | 'bluesky' | 'pinterest' | 'telegram' | 'discord' | 'slack' | 'mastodon' | 'wordpress' | 'ghost' | 'devto' | 'hashnode' | 'tumblr' | 'googlebusiness', required
    - `displayName` string, required
    - `warning` string: Present when the account's authorization has expired, was revoked on the network's side, or expires soon (LinkedIn lasts about 60 days): the user must reconnect it in Breakreach settings
  - `message` string: Present only when no account is connected: explains how to connect one, with the link to the workspace settings

## Other responses

- `401`: Missing, invalid or expired API key
- `402`: No active Breakreach subscription or trial
- `403`: Not a member of the requested workspace
- `404`: Workspace not found

---

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