Discord

Discord works differently from other platforms: it uses webhooks rather than OAuth tokens that you configure within your Discord server. Great for community updates.

Quirks & Gotchas

Webhook-Based Posting

Discord's API prevents third-party applications from posting under user accounts. The webhook approach works as follows:

Connect a Discord server and designate channels to enable.
A webhook is generated for each selected channel.
Messages appear as bot communications, with a customizable name and profile image.

Channel Selection Required

Unlike most platforms, you must include a channelId when submitting post data. You can find available channels in the socialAccount.channels array.

Custom Bot Identity

Customize your bot's appearance with:

username: up to 80 characters, representing the message author name.
avatarUrl: image URL serving as the bot's profile picture.

Media Limits

Constraint	Value
Files	0–10 (images and/or videos, mixed allowed)
Video max size	25 MB
Image max size	25 MB
Text	Max 2,000 characters

Text & Field Limits

Field	Limit
`text`	Max 2,000 characters
`username`	Max 80 characters
`avatarUrl`	Max 2,048 characters

Post Options

Field	Type	Description
`channelId`	`string`	Required. The channel to post to. Found in `socialAccount.channels`.
`text`	`string`	Message content. Max 2,000 characters.
`uploadIds`	`string[]`	Media attachments (images, videos).
`username`	`string`	Custom display name. Max 80 characters.
`avatarUrl`	`string`	Custom avatar URL. Max 2,048 characters.

await bundle.post.create({
  socialAccountTypes: ["DISCORD"],
  data: {
    DISCORD: {
      channelId: "123456789012345678",
      text: "Hello from Bulkit!",
      username: "My Bot",
      avatarUrl: "https://example.com/avatar.png"
    }
  }
});

Analytics

Discord's API does not provide analytics data. All metrics default to zero.

Metric	Note
`impressions`	Returns `0`
`views`	Returns `0`
`likes`	Returns `0`
`comments`	Returns `0`

On this page