Connect a Telegram, Discord or Slack channel
POST/:workspaceUuid/accounts/connect/:provider
Connects a channel that uses a bot token or a webhook URL instead of a login. The credentials
are checked against the network first, stored encrypted and never returned. Connecting the same
channel again updates it (200) instead of adding a second account. Workspace admins only;
counts toward the plan's social account limit.
- telegram:
bot_tokenfrom @BotFather andchat(the channel's@username, or its numeric id such as-1001234567890for a private channel). The bot must be an administrator of the channel allowed to post messages. - discord:
webhook_urlfrom Channel settings → Integrations → Webhooks (https://discord.com/api/webhooks/…). - slack:
webhook_urlof an incoming webhook (https://hooks.slack.com/services/…) and an optional displayname. Slack posts cannot be deleted from PostBoost, and images must be publicly reachable.
Webhook URLs on any other host are refused (422) before any request is made.
Request
Responses
- 200
- 201
- 401
- 403
- 404
- 422
The channel was already connected; its details and credentials were updated.
Channel connected.
Missing or invalid API token.
The caller is not a workspace admin, or the plan's social account limit is reached.
Unknown provider, or the channel is switched off on this instance.
Validation failed.