Skip to main content
Webhooks allow Dojah to push real-time event notifications to your server the moment something happens on your account, a verification is completed, an AML screening returns a result, or an address check is finished. Instead of your system polling the Dojah API repeatedly to check for updates, webhooks deliver the data to you the instant it is ready. Each webhook subscription targets a specific app and service type and delivers events to a URL endpoint on your server.

​
Creating a webhook subscription

Click Subscribe. Fill in three fields: App name: Select the app whose events you want to receive. Only events from this app will be delivered to the webhook. Webhook URL: Enter the full HTTPS URL of the endpoint on your server that will receive the webhook payloads. This must be a publicly accessible URL; localhost addresses will not work in the live environment. Use a tool like webhook.site during development to test event payloads before pointing to your production endpoint. Service name: Select the Dojah service whose events you want to subscribe to. Available services are:
  • SMS: messaging delivery events
  • NG Wallet: wallet transaction events
  • KYC Widget: EasyOnboard KYC flow completion events
  • AML Monitoring: AML and watchlist screening result events
  • Address: address verification completion events
  • Business Registration: business registration events
Each subscription covers one service. If you need webhooks for multiple services, create separate subscriptions for each. Click Subscribe to activate. Events for the selected service and app will begin being delivered to your endpoint immediately.