List channels

Every network Postel can post to, and whether this workspace has it connected. Connected channels come first, the order a dropdown should show. Use a channel's id as platform when you create a post.

Request

curl -X GET "https://www.postel.app/api/v1/channels"

curl -X GET "https://www.postel.app/api/v1/channels"

Response

200

{
  "channels": [
    {
      "id": "linkedin",
      "name": "LinkedIn",
      "account": "Robin Faraj",
      "connected": true,
      "status": "ok",
      "label": "LinkedIn (Robin Faraj)"
    },
    {
      "id": "x",
      "name": "X",
      "account": "@postelapp",
      "connected": true,
      "status": "expiring",
      "label": "X (@postelapp)"
    },
    {
      "id": "bluesky",
      "name": "Bluesky",
      "account": null,
      "connected": false,
      "status": "disconnected",
      "label": "Bluesky (not connected)"
    }
  ]
}

Try it

Authorization

bearerAuth

AuthorizationBearer <token>

A Postel API key, Authorization: Bearer pstl_…. Create one in Postel under Settings → API & MCP; it acts for the workspace it was made in.

In: header

Try it

Authorization

Responses

`application/json`

`application/json`

`application/json`

`application/json`

List channels

Try it

Authorization

Responses

200application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`