Channels API

List and manage publishing channels for your connections.

List Channels

Retrieve all channels in a workspace.


GET /rest/v1/channels?workspace_id=eq.<workspace-id>&select=*,connections(*)

Response


[
  {
    "id": 5,
    "workspace_id": "uuid",
    "connection_id": 1,
    "placement": "instagram_account",
    "external_id": "17841400123456789",
    "name": "My Instagram Account",
    "created_at": "2025-01-01T00:00:00Z",
    "connections": {
      "id": 1,
      "platform": "instagram",
      "status": "active"
    }
  }
]

Placement Codes

Each channel has a placement code that identifies the specific destination type:

Code	Platform	Description
`instagram_account`	Instagram	Feed post
`instagram_story`	Instagram	Story
`facebook_page`	Facebook	Page post
`facebook_group`	Facebook	Group post
`linkedin_profile`	LinkedIn	Personal profile post
`linkedin_company`	LinkedIn	Company page post
`x_profile`	X	Profile post
`threads_profile`	Threads	Account post
`telegram_channel`	Telegram	Channel message
`telegram_group`	Telegram	Group message
`discord_channel`	Discord	Channel message
`pinterest_board`	Pinterest	Board pin
`bluesky_profile`	Bluesky	Profile post

Blog Placements

Code	Platform	Description
`wordpress_blog`	WordPress	Blog post
`webflow_site`	Webflow	CMS collection item

Channel Outputs

Channels are linked to automations through the outputs table. Each output represents a channel assignment for an automation:


GET /rest/v1/outputs?automation_id=eq.<id>&select=*,channels(*,connections(*))

Create Output (Assign Channel to Automation)


POST /rest/v1/outputs
Content-Type: application/json
 
{
  "automation_id": 1,
  "channel_id": 5
}

Delete Output (Unassign Channel)


DELETE /rest/v1/outputs?id=eq.<id>