---
title: "List connected channels"
method: GET
path: "/api/connections"
tags: ["Connections"]
---

# List connected channels

`GET /api/connections`

## Request

- Base URL: `https://api-app.postnext.io`
- URL: `https://api-app.postnext.io/api/connections`
- Auth: API key in header `x-api-key`

Returns a bare JSON array of the caller's connected channels (NOT wrapped
in the `success`/`data` envelope). Use `requiresAttention` (not
`tokenExpiry`) to decide whether a channel needs re-authentication.

## Response `200`

Array of connections

- Connection[]
  - `channelName` string
  - `provider` 'twitter' | 'instagram' | 'linkedin' | 'threads' | 'youtube' | 'tiktok' | 'bluesky'
  - `providerId` string
  - `createdAt` string, date-time
  - `tokenExpiry` string, date-time
  - `avatar` string, nullable
  - `isActive` boolean
  - `requiresAttention` boolean: True only when a token refresh actually failed.
  - `uniqueId` string

## Other responses

- `401`: Missing or invalid API key

---

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