Skip to main content
POST
Create a new user webhook
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.
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 an x-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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-organization-id
string
required

RSA encrypted organization ID (base64 format)

Example:

"BASE64_ENCRYPTED_ORG_ID_HERE"

Body

application/json
url
string
required

The URL to which webhook events will be sent.

Example:

"https://webhook.site/your-endpoint"

events
string[]
required

List of events this webhook is subscribed to.

Example:
secret
string
required

Secret used to sign webhook payloads.

Example:

"mySuperSecret"

is_active
boolean

Whether the webhook is active.

Example:

true

Response

201 - undefined