Skip to main content
POST/api/v1/webhook/subscribe
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.

Headers

Body parameters

Response

A 200 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 an x-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.

Errors