Setting up webhooks
Webhooks notify another service when something happens in NovaDocs (for example an article is published).
1. Create a webhook
- Open Admin → Webhooks
- Add a new webhook
- Paste the target URL
- Choose which events to receive
- Save
2. Discord
Paste a Discord channel webhook URL. NovaDocs detects Discord URLs and sends a rich embed message.
You do not need a secret for Discord webhooks.
3. Custom URL
Use any HTTPS endpoint that accepts POST JSON.
If you set a secret, NovaDocs sends a signature header:
X-NovaDocs-Signature — HMAC SHA-256 of the body, using your secret.
Verify it on your server before trusting the payload.
4. Test
Use Test webhook in admin. You should see a delivery in the log and a message in Discord / your endpoint.
Events
| Event | When it fires |
|---|---|
article.published | Article is published / merged |
article.updated | Article content changes |
article.deleted | Article is deleted |
project.updated | Project settings change |
test | Manual test only |
