content_channels_bind
Bind a channel to a platform connector so posts can be published through it.
Bind a channel to a platform connector so posts can be published through it. Clears an existing pause — rebinding is how a revoked or expired connection is fixed. Pass deliveryMode "auto" to also switch the channel to automatic publishing; binding alone never does.
Behavior
- HTTP
POST /content/channels/:id/bind
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | • | The channel id returned by content_channels_list. |
| connectorId | string | • | The platform connector to publish through — the id of a connector attached to this product, from the workspace connectors list. Networks with no publishing connector (instagram, LinkedIn company pages) are rejected. |
| deliveryMode | string | — | Pass auto to make this API publish through the connector. Omit to keep the current mode: binding alone never switches a channel to automatic publishing. |
Response
| Field | Type | Always | Description |
|---|---|---|---|
| id | string | • | Channel id — pass this to content_publications_schedule. |
| network | string | • | Social network: linkedin, x, youtube, instagram or reddit. |
| pausedAt | string | • | ISO-8601 time the connector stopped working, or null when healthy. A paused channel keeps its scheduled publications — they are frozen, not cancelled, and dispatch once it resumes. |
| createdAt | string | • | ISO-8601 creation time. |
| updatedAt | string | • | ISO-8601 time of the last change. |
| connectorId | string | • | Platform connector this channel publishes through, or null for a reminder channel that needs none. An id — this toolkit never holds social credentials; a token is fetched per call and discarded. |
| displayName | string | • | Human label for the channel. |
| pauseReason | string | • | Why it paused: revoked (access was taken away), expired (the credential ran out), or the provider reason code from a failed publish. Null when healthy. |
| subjectType | string | • | Who publishes: member (a personal account) or organization (a company page). Phase 1 channels are all member accounts. |
| capabilities | object | • | What the channel accepts and what it costs: maxTextLength, maxMedia, supportsVideo, supportsLink, costPerPostUsd, costPerLinkPostUsd, dailyPostCeiling, ceilingIsRuntimeData. Read maxTextLength before writing a per-channel text variant. |
| deliveryMode | string | • | How the post reaches the network: auto (this API publishes it) or reminder (the system prepares it and notifies a person, who publishes by hand). Every seeded channel is reminder. |
Try it
Bind a channel to a platform connector so posts can be published through it.