Webhooks

Webhooks allow external services to send messages to Magne channels without a bot account.

How It Works

Create a webhook on a channel (requires MANAGE_WEBHOOKS permission)
Receive a webhook URL with an embedded token: /v1/webhooks/:id/:token
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"
}

The response includes a one-time token field. Store it securely — it won’t be shown again.

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

Endpoint	Method	Description
`/v1/servers/:id/webhooks`	`GET`	List all webhooks for a server
`/v1/servers/:id/webhooks`	`POST`	Create a new webhook
`/v1/webhooks/:id`	`GET`	Get webhook details
`/v1/webhooks/:id`	`DELETE`	Delete a webhook
`/v1/webhooks/:id/:token`	`POST`	Execute (send message)