Webhooks¶
A webhook sends a JSON POST to your URL each time a record is saved on the pages you choose. Set webhooks up in Admin > API and Webhooks.
The payload¶
{
"event": "/data/contacts.create",
"page": "/data/contacts",
"action": "create",
"record_id": "1234",
"user": "aisha",
"summary": {
"title": "New contact",
"fields": [ { "label": "Name", "value": "Example Sdn Bhd" } ]
},
"at": "2026-11-20T08:15:00Z"
}
record_id is a string. summary holds the form's fields as they were saved, with tables of lines under tables when the form has them, with record ids shown by name. Fields with "password" or "secret" in their name are left out.
Checking the signature¶
If the webhook has a secret, each request carries X-Signature: sha256=<hex>, which is the HMAC-SHA256 of the raw body under that secret. Check it before trusting the request:
import hmac, hashlib
def valid(secret: bytes, body: bytes, header: str) -> bool:
expected = "sha256=" + hmac.new(secret, body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, header)
Delivery¶
- Answer with a 2xx status within 15 seconds.
- A failed delivery is tried once more a minute later. The last result shows on the webhook in the system.
- Requests come with
User-Agent: nbs-webhooks/1.