Zernio
Zernio
API Reference

Discord

Settings

Get Discord account settingsGETUpdate Discord settingsPATCHList Discord guild channelsGET

Messaging

Send a Discord Direct MessagePOSTList pinned messagesGETPin a Discord messagePUTUnpin a Discord messageDELETECreate a Discord public threadPOSTCrosspost Discord messagePOSTDelete a Discord channel messageDELETE

Roles & Members

List Discord guild rolesGETCreate a Discord guild rolePOSTEdit a Discord guild rolePATCHDelete a Discord guild roleDELETEList Discord guild membersGETSearch Discord guild membersGETGet a Discord guild memberGETAssign a role to a guild memberPUTRemove a role from a guild memberDELETE

Scheduled Events

List Discord scheduled eventsGETCreate a Discord scheduled eventPOSTGet a Discord scheduled eventGETUpdate a Discord scheduled eventPATCHDelete a Discord scheduled eventDELETE
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Discord

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

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.updateDiscordSettings({  path: {    accountId: 'account_abc123',  },  body: {    webhookUsername: 'Example',    webhookAvatarUrl: 'https://example.com',    channelId: 'channel_abc123',  },});console.log(data);
{  "message": "string",  "account": {    "_id": "string",    "platform": "string",    "username": "string",    "displayName": "string",    "profilePicture": "string",    "channelId": "string",    "channelName": "string",    "channelType": "string",    "guildId": "string",    "webhookUsername": "string",    "webhookAvatarUrl": "string"  }}
Was this page helpful?

Get Discord account settings

Returns the current Discord account settings including webhook identity (display name and avatar), connected channel, and guild information.

List Discord guild channels

Returns the text, announcement, and forum channels in the connected Discord guild. Use this to discover available channels when switching the connected channel via PATCH /v1/accounts/{accountId}/discord-settings.

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.