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/orembeds(up to 10).usernameandavatarUrl(https) change the name and avatar of that message only. Names that pass for Falafy are refused.?wait=truereturns 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.