Webhook integration guide
Set up real-time event notifications from NAWA to your application. This guide covers endpoint creation, signature verification, and event handling for popular frameworks.Overview
1
Create your endpoint
Build an HTTP endpoint that accepts POST requests and returns a 200 status.
2
Register the webhook
Register your endpoint URL in the NAWA dashboard and save the signing secret.
3
Verify signatures
Validate the HMAC-SHA256 signature on every incoming webhook to prevent forgery.
4
Handle events
Process events based on their type and respond within 30 seconds.
Step 1: Create your endpoint
Your webhook endpoint must:- Accept
POSTrequests withapplication/jsonbody - Return a
200status code within 30 seconds - Be publicly accessible via HTTPS
Step 2: Register the webhook
- Go to trynawa.com/developers/keys
- Click Add Endpoint
- Enter your endpoint URL (e.g.,
https://yourapp.com/webhooks/nawa) - Select the events you want to receive
- Copy the signing secret (
nawa_wh_xxx) - it’s shown only once
Step 3: Verify signatures and handle events
Testing
A dedicated webhook test-fire endpoint is planned. In the meantime, test your handler by sending a POST request directly to your endpoint with a sample payload.