falafy
EN
Download free

Public API v1 · @falafy/bot

Incoming webhooks

One secret URL per webhook posts messages to a channel, with no bot and no login.

Create

People with the Manage webhooks permission create them in Channel settings > Webhooks (or Server settings > Integrations). The URL is shown once; generating a new one invalidates the old. Bots create them with POST /api/v1/channels/{channelId}/webhooks.

Execute

curl -X POST "https://falafy.com.br/api/v1/webhooks/WEBHOOK_ID/TOKEN?wait=true" \
  -H "content-type: application/json" \
  -d '{"username":"CI","content":"Deploy feito","embeds":[{"title":"Build #42","color":3108715,"fields":[{"name":"branch","value":"main","inline":true}]}]}'
  • content (up to 2000 characters) and/or embeds (up to 10).
  • username and avatarUrl (https) change the name and avatar of that message only. Names that pass for Falafy are refused.
  • ?wait=true returns the created message (to edit it later); without it the response is 204.
  • Messages show the APP badge and never mention anyone.

Edit and delete

With the same URL: PATCH and DELETE /api/v1/webhooks/{id}/{token}/messages/{messageId} (only that webhook’s messages). GET, PATCH (name) and DELETE on /api/v1/webhooks/{id}/{token} read, rename or delete the webhook.

Limits

Up to 10 webhooks per channel and a bucket of 10 requests every 2 seconds per webhook. A deleted webhook answers 404: stop calling it.