POST
Register a callback URL so Dojah POSTs events to your server as they happen — verification results, SMS delivery, address checks, and AML monitoring hits. One subscription per service, per environment.
/api/v1/webhook/subscribeHeaders
Body parameters
Response
A200 returns a confirmation string in entity. Dojah then delivers each event as a POST to your URL. Payloads arrive at the top level with no entity wrapper — verify them before trusting the contents.
Verifying deliveries
Every webhook request carries anx-dojah-signature (HMAC-SHA256 of the JSON payload, keyed with your secret) and originates from Dojah’s IP 135.119.89.106. Confirm the signature on every request before acting on it. See Webhooks & signatures for the full verification recipe and payload reference. Any file URLs inside a payload expire in about an hour — download them promptly.