Core Concepts
Channels
The Facebook Pages and Instagram accounts connected to your organization.
A channel is a connected social destination — a Facebook Page or an Instagram
account. Internally Dynamo calls these mediums, a term you'll occasionally see in
raw model responses (e.g. the mediumsData field).
Types
type (EMediumType) | Destination |
|---|---|
FB_PAGE | A Facebook Page. |
INSTAGRAM_ACCOUNT | An Instagram account. |
Listing channels
GET /channels returns the channels your org can post to. Each item has an id,
type, and name.
[
{ "id": "FB_PAGE_123456789012345", "type": "FB_PAGE", "name": "Acme Sports" }
]The id is the key you use everywhere else — most importantly as the key in a
scheduled post's channels map:
"channels": {
"FB_PAGE_123456789012345": { "mediumType": "FB_PAGE", "caption": "Hello 👋" }
}Workspace scoping
Pass the optional workspaceId filter to return only the channels connected to a given
workspace — the discovery step for the
workspace-scoped VIP routes.
See GET /channels.