​

Webhooks

​

How It Works

1. Create a webhook on a channel (requires MANAGE_WEBHOOKS permission)
2. Receive a webhook URL with an embedded token: /v1/webhooks/:id/:token
3. POST messages to the URL — no authentication header needed

​

Creating a Webhook

POST /v1/servers/:server_id/webhooks
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "channelId": "channel-uuid",
  "name": "GitHub Notifications",
  "avatarUrl": "https://example.com/github-avatar.png"
}

​

Executing a Webhook

POST /v1/webhooks/:webhook_id/:token
Content-Type: application/json

{
  "content": "New commit pushed to main branch"
}

• No Authorization header required — the token in the URL is the credential
• Content must be 1–4,000 characters
• Messages appear in the channel with the webhook’s name and avatar
• Rate limited to 30 requests per 60 seconds per webhook

​

Management