Send messages, embeds, polls, forum posts, and threads to Discord servers with Zernio API - No bot hosting, no gateway, no intents approval

Quick Reference

Property	Value
Content limit	2,000 characters (message content)
Embeds per message	10 (max 6,000 chars total)
Images per message	Up to 10 attachments
Image formats	JPEG, PNG, GIF, WebP
Image max size	25 MB (higher on boosted servers)
Video formats	MP4, MOV, WebM
Video max size	25 MB (up to 500 MB on boosted servers)
Post types	Messages, Embeds, Polls, Forum Posts, Threads
Scheduling	Yes
Inbox (DMs)	No
Inbox (Comments)	No
Analytics	No

Discord integration uses a centralized bot token model. You do NOT need to create a Discord Application, request privileged intents, or host a gateway connection. You add the Zernio bot to your server via OAuth and POST to our REST API.

Key points:

No bot hosting required - we manage the bot infrastructure
No intents approval - MESSAGE_CONTENT and other privileged intents are handled at the bot level
No gateway/sharding - you never connect a WebSocket; everything is REST
The bot needs: Send Messages, Embed Links, Attach Files, Send Messages in Threads, Create Public Threads permissions (granted at install time)

Quick Start

Send a message to a Discord channel:

const { post } = await zernio.posts.createPost({
  content: 'Hello from Zernio API!',
  platforms: [
    {
      platform: 'discord',
      accountId: 'YOUR_ACCOUNT_ID',
      platformSpecificData: {
        channelId: '1234567890'
      }
    }
  ],
  publishNow: true
});
console.log('Posted to Discord!', post._id);

result = client.posts.create(
    content="Hello from Zernio API!",
    platforms=[
        {
            "platform": "discord",
            "accountId": "YOUR_ACCOUNT_ID",
            "platformSpecificData": {
                "channelId": "1234567890"
            }
        }
    ],
    publish_now=True,
)
print(f"Posted to Discord! {result.post['_id']}")

curl -X POST https://zernio.com/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from Zernio API!",
    "platforms": [
      {
        "platform": "discord",
        "accountId": "YOUR_ACCOUNT_ID",
        "platformSpecificData": {
          "channelId": "1234567890"
        }
      }
    ],
    "publishNow": true
  }'

Connection

Discord uses OAuth2 with our centralized bot:

Call GET /v1/connect/discord?profileId=YOUR_PROFILE_ID to get the bot invite URL
The user authorizes the bot to join their server
After authorization, the user selects which channel to post to via /connect/discord/select-channel
The connected account appears in GET /v1/accounts

Each connected account represents one Discord server. The channelId in platformSpecificData determines which channel receives the message.

Embeds

Send rich embedded content alongside or instead of plain text:

{
  "content": "New release shipping today!",
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "1234567890",
      "embeds": [{
        "title": "v2.3.0 Release Notes",
        "description": "Dark mode, new API endpoints, faster uploads.",
        "color": 5814783,
        "url": "https://example.com/changelog",
        "footer": { "text": "Shipped today" },
        "fields": [
          { "name": "New Features", "value": "3", "inline": true },
          { "name": "Bug Fixes", "value": "12", "inline": true }
        ]
      }]
    }
  }],
  "publishNow": true
}

Each message supports up to 10 embeds with a combined character limit of 6,000 across all embed fields.

Native Polls

Create Discord-native polls (same UX as the Discord client):

{
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "1234567890",
      "poll": {
        "question": { "text": "Ship it now or wait until Monday?" },
        "answers": [
          { "poll_media": { "text": "Ship now" } },
          { "poll_media": { "text": "Wait for Monday" } }
        ],
        "duration": 24,
        "allow_multiselect": false
      }
    }
  }],
  "publishNow": true
}

Poll Property	Value
Max answers	10
Duration range	1 - 768 hours (32 days)
Default duration	24 hours
Multi-select	Optional (default: false)

Polls are standalone messages. You cannot combine a poll with media attachments in the same message (Discord API limitation).

Forum Posts

Post starter messages to forum channels (type 15):

{
  "content": "Community call notes for January 15",
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "9999999999",
      "forumThreadName": "Community Call - Jan 15",
      "forumAppliedTags": ["11111111", "22222222"]
    }
  }],
  "publishNow": true
}

forumThreadName (required for forum channels) becomes the thread title
forumAppliedTags are snowflake IDs of existing forum tags
Use listForumTags(channelId) to discover available tags

Threads

Create a follow-up thread under any published message:

{
  "content": "Main announcement here",
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "1234567890",
      "threadFromMessage": {
        "name": "Discussion Thread",
        "autoArchiveDuration": 1440
      }
    }
  }],
  "publishNow": true
}

autoArchiveDuration options: 60, 1440 (1 day), 4320 (3 days), or 10080 (7 days) minutes.

Announcement Crosspost

Auto-crosspost messages from announcement channels (type 5) so followers in other servers receive them:

{
  "platformSpecificData": {
    "channelId": "ANNOUNCEMENT_CHANNEL_ID",
    "crosspost": true
  }
}

This is a no-op for regular text channels.

Edit & Delete

Edit: PUT /v1/posts/{postId} updates the Discord message content and embeds
Delete: DELETE /v1/posts/{postId} deletes the Discord message or cancels a scheduled one

Rate Limits

Discord applies per-channel, per-guild, and global rate limits. Zernio handles 429 responses with exponential backoff and respects the X-RateLimit-Reset-After header automatically. You never need to implement retry logic.

platformSpecificData Reference

Field	Type	Required	Description
`channelId`	string	Yes	Target channel snowflake ID
`embeds`	array	No	Up to 10 Discord embed objects
`poll`	object	No	Native poll (question, answers, duration)
`crosspost`	boolean	No	Auto-crosspost in announcement channels
`forumThreadName`	string	Forum channels	Thread title for forum starter message
`forumAppliedTags`	string[]	No	Tag snowflake IDs for forum posts
`threadFromMessage`	object	No	Create a thread under the published message
`tts`	boolean	No	Text-to-speech message

Quick Reference

Property	Value
Content limit	2,000 characters (message content)
Embeds per message	10 (max 6,000 chars total)
Images per message	Up to 10 attachments
Image formats	JPEG, PNG, GIF, WebP
Image max size	25 MB (higher on boosted servers)
Video formats	MP4, MOV, WebM
Video max size	25 MB (up to 500 MB on boosted servers)
Post types	Messages, Embeds, Polls, Forum Posts, Threads
Scheduling	Yes
Inbox (DMs)	No
Inbox (Comments)	No
Analytics	No

Before You Start

Key points:

No bot hosting required - we manage the bot infrastructure
No intents approval - MESSAGE_CONTENT and other privileged intents are handled at the bot level
No gateway/sharding - you never connect a WebSocket; everything is REST
The bot needs: Send Messages, Embed Links, Attach Files, Send Messages in Threads, Create Public Threads permissions (granted at install time)

Quick Start

Send a message to a Discord channel:

const { post } = await zernio.posts.createPost({
  content: 'Hello from Zernio API!',
  platforms: [
    {
      platform: 'discord',
      accountId: 'YOUR_ACCOUNT_ID',
      platformSpecificData: {
        channelId: '1234567890'
      }
    }
  ],
  publishNow: true
});
console.log('Posted to Discord!', post._id);

result = client.posts.create(
    content="Hello from Zernio API!",
    platforms=[
        {
            "platform": "discord",
            "accountId": "YOUR_ACCOUNT_ID",
            "platformSpecificData": {
                "channelId": "1234567890"
            }
        }
    ],
    publish_now=True,
)
print(f"Posted to Discord! {result.post['_id']}")

curl -X POST https://zernio.com/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from Zernio API!",
    "platforms": [
      {
        "platform": "discord",
        "accountId": "YOUR_ACCOUNT_ID",
        "platformSpecificData": {
          "channelId": "1234567890"
        }
      }
    ],
    "publishNow": true
  }'

Connection

Discord uses OAuth2 with our centralized bot:

Call GET /v1/connect/discord?profileId=YOUR_PROFILE_ID to get the bot invite URL
The user authorizes the bot to join their server
After authorization, the user selects which channel to post to via /connect/discord/select-channel
The connected account appears in GET /v1/accounts

Each connected account represents one Discord server. The channelId in platformSpecificData determines which channel receives the message.

Embeds

Send rich embedded content alongside or instead of plain text:

{
  "content": "New release shipping today!",
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "1234567890",
      "embeds": [{
        "title": "v2.3.0 Release Notes",
        "description": "Dark mode, new API endpoints, faster uploads.",
        "color": 5814783,
        "url": "https://example.com/changelog",
        "footer": { "text": "Shipped today" },
        "fields": [
          { "name": "New Features", "value": "3", "inline": true },
          { "name": "Bug Fixes", "value": "12", "inline": true }
        ]
      }]
    }
  }],
  "publishNow": true
}

Each message supports up to 10 embeds with a combined character limit of 6,000 across all embed fields.

Native Polls

Create Discord-native polls (same UX as the Discord client):

{
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "1234567890",
      "poll": {
        "question": { "text": "Ship it now or wait until Monday?" },
        "answers": [
          { "poll_media": { "text": "Ship now" } },
          { "poll_media": { "text": "Wait for Monday" } }
        ],
        "duration": 24,
        "allow_multiselect": false
      }
    }
  }],
  "publishNow": true
}

Poll Property	Value
Max answers	10
Duration range	1 - 768 hours (32 days)
Default duration	24 hours
Multi-select	Optional (default: false)

Polls are standalone messages. You cannot combine a poll with media attachments in the same message (Discord API limitation).

Forum Posts

Post starter messages to forum channels (type 15):

{
  "content": "Community call notes for January 15",
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "9999999999",
      "forumThreadName": "Community Call - Jan 15",
      "forumAppliedTags": ["11111111", "22222222"]
    }
  }],
  "publishNow": true
}

forumThreadName (required for forum channels) becomes the thread title
forumAppliedTags are snowflake IDs of existing forum tags
Use listForumTags(channelId) to discover available tags

Threads

Create a follow-up thread under any published message:

{
  "content": "Main announcement here",
  "platforms": [{
    "platform": "discord",
    "accountId": "YOUR_ACCOUNT_ID",
    "platformSpecificData": {
      "channelId": "1234567890",
      "threadFromMessage": {
        "name": "Discussion Thread",
        "autoArchiveDuration": 1440
      }
    }
  }],
  "publishNow": true
}

autoArchiveDuration options: 60, 1440 (1 day), 4320 (3 days), or 10080 (7 days) minutes.

Announcement Crosspost

Auto-crosspost messages from announcement channels (type 5) so followers in other servers receive them:

{
  "platformSpecificData": {
    "channelId": "ANNOUNCEMENT_CHANNEL_ID",
    "crosspost": true
  }
}

This is a no-op for regular text channels.

Edit & Delete

Edit: PUT /v1/posts/{postId} updates the Discord message content and embeds
Delete: DELETE /v1/posts/{postId} deletes the Discord message or cancels a scheduled one

Rate Limits

platformSpecificData Reference

Field	Type	Required	Description
`channelId`	string	Yes	Target channel snowflake ID
`embeds`	array	No	Up to 10 Discord embed objects
`poll`	object	No	Native poll (question, answers, duration)
`crosspost`	boolean	No	Auto-crosspost in announcement channels
`forumThreadName`	string	Forum channels	Thread title for forum starter message
`forumAppliedTags`	string[]	No	Tag snowflake IDs for forum posts
`threadFromMessage`	object	No	Create a thread under the published message
`tts`	boolean	No	Text-to-speech message

Discord API

Quick Reference

Before You Start

Quick Start

Connection

Embeds

Native Polls

Forum Posts

Threads

Announcement Crosspost

Edit & Delete

Rate Limits

platformSpecificData Reference

On this page

Discord API

Quick Reference

Before You Start

Quick Start

Connection

Embeds

Native Polls

Forum Posts

Threads

Announcement Crosspost

Edit & Delete

Rate Limits

platformSpecificData Reference

On this page