Channels
/channels
Lists the social accounts and ad accounts connected to a project, grouped by provider. Channel ids from this endpoint are what you pass when creating a post.
What each channel accepts
| Channel | Stills | Video | Comments | Can be taken down |
|---|---|---|---|---|
| 1:1, 4:5, 16:9 | 9:16 only — a feed video publishes as a Reel | yes | no — remove it in Instagram | |
| Facebook Page | 1:1, 4:5, 16:9 | 1:1, 4:5, 9:16, 16:9 | yes | yes |
| TikTok | 9:16 | 9:16 | no | no — remove it in TikTok |
| X | 1:1, 4:5 | 1:1, 4:5, 9:16, 16:9 | yes | yes |
| Threads | 1:1, 4:5, 9:16, 16:9 | 1:1, 4:5, 9:16, 16:9 | yes | yes |
| Bluesky | 1:1, 4:5, 9:16, 16:9 | 1:1, 4:5, 9:16, 16:9 | yes | yes |
| 1:1, 4:5 — up to 5 as a carousel | 1:1, 4:5, 9:16 — one per Pin | no | yes |
A format outside the accepted ratios is refused when the post is created, not when it publishes, so a bad plan fails immediately rather than a month later. auto_delete_after_seconds and POST /posts/{post_id}/retract both need a channel in the last column.
Paginate with cursor: pass the next_cursor from the previous page. It is absent on the last page.
Requires the channels:read scope.
get/projects/{project_id}/channels
Request
- Base URL: https://api.productbyte.com/v1
- URL: https://api.productbyte.com/v1/projects/{project_id}/channels
- Auth: HTTP bearer
Path parameters
project_idstring required
The project to list channels for.
Query parameters
limitinteger
Page size, 1–100.
cursorstring
A next_cursor from a previous page.
Response
A page of channels.
Changes
No recorded changes to this operation across all 2 revisions of this API.