Discord - Kavenio

Kavenio publishes to Discord through a connected bot and channel webhook. Use discord as the platform value in post payloads.

Quick Reference

Capability	Support
Platform key	`discord`
Connect	Discord bot install flow
Text post	Supported
Image post	Supported
Video post	Supported
Document attachment	Supported
Webhook identity	Configurable per connected account
Native edit/delete	Supported for Kavenio-published messages
Direct messages	Supported for users reachable by the bot
Roles and members	Supported
Pins	Supported
Scheduled events	Supported
Analytics	Not supported
Inbox/Gateway events	Not supported

Connect

Start a Discord connect flow through the shared connect API:

POST /v1/connect/begin

Select discord as the provider. Discord accounts are connected through a bot install flow. Kavenio stores bot and webhook credentials encrypted and never returns provider secrets in API responses. After connect, select a postable channel:

GET /v1/accounts/{accountId}/discord-channels
PATCH /v1/accounts/{accountId}/discord-settings

Channel selection creates or rotates the account webhook for that channel.

Create A Post

Create Discord posts through the shared posts API:

{
  "profileId": "customer_user_123",
  "content": "Shipping a product update today.",
  "platforms": [
    {
      "platform": "discord",
      "accountId": "acc_123"
    }
  ],
  "publishNow": true
}

kavenio posts create \
  --profile-id customer_user_123 \
  --content "Shipping a product update today." \
  --publish-now \
  --platform discord:acc_123

Settings

Discord account settings include the selected guild, selected channel, and webhook display identity:

GET /v1/accounts/{accountId}/discord-settings
PATCH /v1/accounts/{accountId}/discord-settings

Use webhookUsername and webhookAvatarUrl to customize the webhook identity. Use channelId to switch the posting channel.

Direct Messages

Send a direct message through the connected bot:

POST /v1/discord/dms

{
  "accountId": "acc_123",
  "userId": "123456789012345678",
  "content": "Your support request was updated."
}

The user must be reachable by the bot under Discord provider rules.

Roles And Members

Discord role and member management is guild scoped:

GET /v1/discord/guilds/{guildId}/roles
GET /v1/discord/guilds/{guildId}/members
PUT /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}
DELETE /v1/discord/guilds/{guildId}/members/{userId}/roles/{roleId}

Kavenio rejects attempts to mutate the @everyone role.

Pins

Pin management is channel scoped:

GET /v1/discord/channels/{channelId}/pins
PUT /v1/discord/channels/{channelId}/pins/{messageId}
DELETE /v1/discord/channels/{channelId}/pins/{messageId}

The channel must belong to the connected Discord account’s guild. Discord’s 50-pin cap is surfaced as a validation error with provider details.

Scheduled Events

Scheduled event management is guild scoped:

POST /v1/discord/guilds/{guildId}/events
GET /v1/discord/guilds/{guildId}/events
GET /v1/discord/guilds/{guildId}/events/{eventId}
PATCH /v1/discord/guilds/{guildId}/events/{eventId}
DELETE /v1/discord/guilds/{guildId}/events/{eventId}

Create payloads support external, voice, and stage_instance events. Use status: "cancelled" with PATCH to cancel an event. Use DELETE only for hard deletion.

Health

Run account health after setup or when publishing fails:

POST /v1/accounts/{accountId}/health

Discord health checks verify the selected channel is still postable, refresh readiness metadata, and surface missing setup or permission drift. Kavenio does not use Discord Gateway behavior for publish, DM, role, pin, event, or health operations.

​Quick Reference

​Connect

​Create A Post

​Settings

​Direct Messages

​Roles And Members

​Pins

​Scheduled Events

​Health