Channel Update
channel_updateUpdates a channel's name, active status, publishing and comment handling, or type-specific settings and credentials; only supplied fields change.
Instructions
Change a channel: its name, whether it is active, publishing and comment handling of a social account, or the settings and credentials of its type. Only what is given changes. Turning publishingEnabled on makes the channel a target for post_schedule. A new login of a connected account is channel_connect with the channelId.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"organizationId": "<organizationId>",
"channelId": "<channelId>"
},
"name": "channel_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New name of the channel. | |
| emailSsl | No | EMAIL: connect with SSL/TLS. | |
| activated | No | false pauses the channel: nothing is fetched or sent. | |
| channelId | Yes | The channel id (see channel_list). | |
| emailHost | No | EMAIL: mail server host name, e.g. mail.example.com. | |
| emailPort | No | EMAIL: SMTP port, e.g. 465 or 587. | |
| commentMode | No | Social accounts: which comments on posts become conversations. ALL, QUESTIONS (emoji-only and off-topic comments are closed quietly) or NONE. | |
| telegramChat | No | TELEGRAM: the Telegram channel the bot posts to (@name, a t.me link or the id); the bot has to be an administrator of it. Optional: without it the channel only receives messages to the bot. | |
| webchatColor | No | WEBCHAT: accent color as hex, e.g. #2563eb. | |
| webchatTheme | No | WEBCHAT: widget theme. | |
| webchatTitle | No | WEBCHAT: title shown in the widget. | |
| appstoreAppId | No | APPSTORE: the app's Apple ID (the number in its App Store link). | |
| appstoreKeyId | No | APPSTORE: key id of the App Store Connect API key. | |
| emailPassword | No | EMAIL: the mailbox password. Stored encrypted, never returned. | |
| emailPortImap | No | EMAIL: IMAP port, e.g. 993. | |
| emailUsername | No | EMAIL: the mailbox address, which is also the login. | |
| emailSignature | No | EMAIL: signature added to replies (HTML). | |
| organizationId | Yes | The organization id. Use organization_list to find it. | |
| appstoreAppName | No | APPSTORE: the app's name. | |
| webchatPosition | No | WEBCHAT: side of the page the launcher sits on. | |
| appstoreIssuerId | No | APPSTORE: issuer id of the App Store Connect API key. | |
| commentAutoReply | No | Social accounts: send AI replies to comments right away instead of keeping them as drafts. | |
| telegramBotToken | No | TELEGRAM: the token of the bot from @BotFather. Stored encrypted. | |
| publishingEnabled | No | Social accounts: let posts be published to this channel (post_schedule). Counts against the plan's publishing limit; the channel has to be allowed to publish (publishingAuthorized, see channel_connect). | |
| appstorePrivateKey | No | APPSTORE: content of the .p8 private key file. Stored encrypted. | |
| blueskyAppPassword | No | BLUESKY: an app password (Bluesky settings, Privacy and security, App passwords), never the account password. Stored encrypted. | |
| playstorePackageName | No | PLAYSTORE: the app's package name, e.g. com.example.app. The organization's service account (channel_playstore_service_account) has to be invited in the Play Console first. | |
| webchatLauncherLabel | No | WEBCHAT: text next to the launcher button. | |
| webchatAllowedDomains | No | WEBCHAT: comma-separated domains the widget may be embedded on. Empty allows every site. | |
| webchatRequireContact | No | WEBCHAT: ask visitors for name and email before they can write. | |
| webchatWelcomeMessage | No | WEBCHAT: first message visitors see. | |
| playstoreApplicationName | No | PLAYSTORE: the app's name. |