Skip to content

Update Discord settings

Update Discord account settings. Supports two operations (can be combined):

  1. Webhook identity - Set the default display name and avatar that appear as the message author on every post. These are account-level defaults; individual posts can override them via platformSpecificData.webhookUsername / webhookAvatarUrl.

  2. Switch channel - Move the connection to a different channel in the same guild. A new webhook is automatically created in the target channel.

PATCH /v1/accounts/{accountId}/discord-settings

Update Discord account settings. Supports two operations (can be combined):

  1. Webhook identity - Set the default display name and avatar that appear as the message author on every post. These are account-level defaults; individual posts can override them via platformSpecificData.webhookUsername / webhookAvatarUrl.

  2. Switch channel - Move the connection to a different channel in the same guild. A new webhook is automatically created in the target channel.

Parameters

  • accountId (path, string) required

Request body

Content-Type: application/json

  • webhookUsername (string) — Custom display name for the webhook (1-80 chars). Empty string resets to default ("Zernio"). Cannot contain "clyde" or "discord".
  • webhookAvatarUrl (string) — Custom avatar URL. Empty string resets to default bot avatar.
  • channelId (string) — Switch to a different channel in the same guild. Must be a text (0), announcement (5), or forum (15) channel.

Responses

200 — Settings updated

  • message (string)
  • account (object)

400 — Invalid request (no changes

401

404 — Discord account not found