Send a Discord Direct Message

Send a 1:1 Direct Message from the bot to a Discord user (by snowflake ID). Supports the same payload shape as channel posts: content, embeds, media attachments, and TTS.

Constraints (Discord platform limits):

• The bot can only DM users it shares at least one guild with.
• If the recipient has DMs disabled for non-friends, Discord returns 403 (surfaces as a 502 platform error).
• content capped at 2,000 chars.
• At least one of content, embeds, or attachments is required.
• The recipient must be identified by Discord snowflake ID (not username).

This is a dedicated endpoint rather than a POST /v1/posts variant because DMs are 1:1 operational messages (onboarding, billing reminders, support pings) with a different lifecycle than scheduled channel posts. DMs are not persisted to Post / ExternalPost and are always sent immediately.

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.sendDiscordDirectMessage({  body: {    accountId: '65a1b2c3d4e5f60718293a4b',    userId: '1234567890123456789',  },});console.log(data);

{  "messageId": "1357924680135792468",  "channelId": "1357924680135792467",  "url": "https://discord.com/channels/@me/1357924680135792467/1357924680135792468",  "timestamp": "2026-06-02T12:34:56.789Z",  "recipient": {    "userId": "1234567890123456789",    "platform": "discord"  },  "account": {    "id": "65a1b2c3d4e5f60718293a4b",    "username": "announcements",    "displayName": "My Server - #announcements"  }}