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

# List connected social accounts

`GET /connections`

## Request

- Base URL: `https://katto.tech/api/v1`
- URL: `https://katto.tech/api/v1/connections`
- Auth: HTTP bearer

Which of the 7 publishable platforms the user connected in the Katto dashboard, with the account's display name and whether a reconnect is needed (expired token that cannot be refreshed, or Mastodon without its instance). Tokens are never returned. Call before POST /jobs/{id}/clips/{index}/publish. Requires read scope.

## Response `200`

Connections, one entry per platform

- object
  - `connections` object[]
    - `platform` 'youtube' | 'tiktok' | 'linkedin' | 'instagram' | 'bluesky' | 'mastodon' | 'threads'
    - `connected` boolean
    - `display_name` string, nullable
    - `reconnect_required` boolean
    - `connected_at` string, date-time, nullable
  - `connect_url` string, uri: Where the user connects or reconnects an account.

## Other responses

- `401`: Error
- `403`: Error
- `429`: Error
- `500`: Error

---

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