Skip to content

content_channels_bind

Bind a channel to a platform connector so posts can be published through it.

Tool

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

NameTypeRequiredDescription
idstringThe channel id returned by content_channels_list.
connectorIdstringThe 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.
deliveryModestringPass 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

FieldTypeAlwaysDescription
idstringChannel id — pass this to content_publications_schedule.
networkstringSocial network: linkedin, x, youtube, instagram or reddit.
pausedAtstringISO-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.
createdAtstringISO-8601 creation time.
updatedAtstringISO-8601 time of the last change.
connectorIdstringPlatform 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.
displayNamestringHuman label for the channel.
pauseReasonstringWhy it paused: revoked (access was taken away), expired (the credential ran out), or the provider reason code from a failed publish. Null when healthy.
subjectTypestringWho publishes: member (a personal account) or organization (a company page). Phase 1 channels are all member accounts.
capabilitiesobjectWhat the channel accepts and what it costs: maxTextLength, maxMedia, supportsVideo, supportsLink, costPerPostUsd, costPerLinkPostUsd, dailyPostCeiling, ceilingIsRuntimeData. Read maxTextLength before writing a per-channel text variant.
deliveryModestringHow 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.

When to use

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.

Example

Ask your agent something like this:

Bind a channel to a platform connector so posts can be published through it.

The agent will invoke content_channels_bind with these arguments:

{
  "id": "<id>",
  "connectorId": "<connectorId>"
}

Esc

Start typing to search the docs.

navigateselect