Webhooks
Register Webhook
deprecated
Register a URL to receive real-time event notifications from DialNexa.
POST
Create a new user webhook
Registers a URL endpoint to receive event notifications. When subscribed events occur, such as a call completing or a campaign finishing, DialNexa sends an HTTP
POST to your URL with a signed JSON payload.
How webhook verification works
Every request DialNexa sends to your endpoint includes anx-dialnexa-signature header. This is an HMAC-SHA256 signature of the raw request body as a bare hex digest (no prefix), generated using the secret you provide when registering the webhook. Verify this signature on your server to confirm the request is genuinely from DialNexa and hasn’t been tampered with.
Available events
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
RSA encrypted organization ID (base64 format)
Example:
"BASE64_ENCRYPTED_ORG_ID_HERE"
Body
application/json
The URL to which webhook events will be sent.
Example:
"https://webhook.site/your-endpoint"
List of events this webhook is subscribed to.
Example:
Secret used to sign webhook payloads.
Example:
"mySuperSecret"
Whether the webhook is active.
Example:
true
Response
201 - undefined
Create a new user webhook