Webhook Reference

Webhook endpoints are served by the TDAB Convex backend

← Back to Home

TDAB Webhook Endpoints

Replace YOUR_DEPLOYMENT with your Convex deployment URL (e.g. https://your-app.convex.site)

Sumsub

KYC verification status updates
<CONVEX_SITE_URL>/webhooks/sumsub

Register in: Sumsub Dashboard -> Integration -> Webhooks

Clerk

User creation and updates
<CONVEX_SITE_URL>/webhooks/clerk

Register in: Clerk Dashboard -> Webhooks

MintBurn

Token mint/burn operations
<CONVEX_SITE_URL>/webhook/mintburn

Register in: MintBurn server configuration

Mambu

Banking and account updates
<CONVEX_SITE_URL>/webhook/mambu

Register in: Mambu Dashboard -> Webhooks

Bank Account Manager

Transaction notifications (encrypted)
<CONVEX_SITE_URL>/webhooks/receive

Register in: Bank Account Manager configuration

How Webhooks Work

  • 1. The onboard app creates a SumSub applicant with a Windhelm user_id as the externalUserId
  • 2. SumSub sends webhook #1 to TDAB when the applicant is created
  • 3. After review in the SumSub dashboard, SumSub sends webhook #2 to TDAB when the applicant is approved/rejected
  • 4. TDAB processes the webhooks and updates user status accordingly