---
title: "Update Discord settings"
method: PATCH
path: "/v1/accounts/{accountId}/discord-settings"
tags: ["Discord"]
---

# Update Discord settings

`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.

## Path parameters

- `accountId` string, required

## Request body

- object
  - `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.

## Response `200`

Settings updated

- object
  - `message` string
  - `account` object
    - `_id` string
    - `platform` string
    - `username` string
    - `displayName` string
    - `profilePicture` string
    - `channelId` string
    - `channelName` string
    - `channelType` string
    - `guildId` string
    - `webhookUsername` string, nullable
    - `webhookAvatarUrl` string, nullable

## Other responses

- `400` — Invalid request (no changes, invalid channel type, or bot cannot access channel)
- `401` — Unauthorized
- `404` — Discord account not found

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)