---
title: "Check a channel connection"
method: GET
path: "/api/connections/{provider}/{channelName}/check"
tags: ["Connections"]
---

# Check a channel connection

`GET /api/connections/{provider}/{channelName}/check`

## Request

- Base URL: `https://api-app.postnext.io`
- URL: `https://api-app.postnext.io/api/connections/{provider}/{channelName}/check`
- Auth: API key in header `x-api-key`

Verifies a single channel connection. The HTTP status mirrors the
`status` field: `active` returns 200, `expired` returns 401, `invalid`
returns 404. The body is a bare status object.

## Path parameters

- `provider` 'twitter' | 'instagram' | 'linkedin' | 'threads' | 'youtube' | 'tiktok' | 'bluesky', required
- `channelName` string, required

## Response `200`

Connection is active

- ConnectionStatus
  - `status` 'active' | 'expired' | 'invalid' | 'error'
  - `message` string
  - `expiresAt` string, date-time
  - `profile` object, nullable: Present only for twitter/instagram/threads live checks.

## Other responses

- `400`: Missing required parameters
- `401`: Token expired
- `404`: Connection not found or unsupported provider

---

[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)