Skip to main content

Webhooks

Webhooks provide real-time notifications to your system when key events occur across the platform. This reference documents all available webhook event triggers, their payloads, and guidance on how to handle them.

Give ChainIT an HTTPS endpoint and pick your events. We send a POST request with a JSON body the moment each one happens — no polling required.

Twelve events across KYB, KYC, and VDT. Setup takes about five minutes in the developer console.

Configure a Webhook​

Five steps in the Developer Console. Pick a step to jump ahead, or let the tour play through in order.

Step 1 of 5

Developer console

Open https://sdk.chainit.online and choose Developer Console in the header. Scan the QR code with ChainIT ID to sign in.

sdk.chainit.online/developer/auth/qrCode

Webhook events​

Every event ChainIT can send, grouped by product. Subscribe to only what your integration needs — each one lists its trigger and a sample payload.

Description

Triggered when a KYB invitation is sent to an organization. This webhook notifies your system that a new organization verification invite has been created and provides invite details, contact information, and current invitation status.

Trigger

  • A KYB invitation is sent to an organization
  • A new organization verification invite has been created

Payload

{
  "event": "KYB_INVITATION_SENT",
  "message": "KYB invitation sent successfully",
  "data": {
    "id": "org_inv_123",
    "name": "ABC Organization",
    "description": "KYB verification invitation",
    "email": "contact@abc.com",
    "phone": "+91XXXXXXXXXX",
    "status": "INVITED",
    "orgId": "org_001",
    "invitorOrgId": "org_999",
    "isExistingOrgInvite": false,
    "rejectionReason": null,
    "relatedTaskId": "task_123",
    "createdAt": "2026-02-27T10:00:00Z"
  },
  "timestamp": "2026-02-27T14:01:54.205Z"
}