About Webhooks

Example

Suppose you have subscribed to the business.updated webhook event, you will receive a notification every time a business is updated.

Event Envelope

Every webhook event is delivered with a standard envelope containing the following top-level fields:

Field	Type	Description
`event_id`	string	A unique UUID identifying this event. Stable across redeliveries — if you receive the same `event_id` twice, you can safely discard the duplicate.
`event_type`	string	The event type code (e.g. `case.created`, `business.updated`).
`timestamp`	string	ISO 8601 timestamp indicating when the event was produced.
`payload`	object	The event-specific data. See each event type below for its payload shape.

{
  "event_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "event_type": "case.status_updated",
  "timestamp": "2026-06-01T14:30:00.000Z",
  "payload": {
    ...
  }
}

Idempotency

Events may be delivered more than once (for example, due to network retries). Each event includes a unique event_id that remains stable across redeliveries of the same event. Your integration should track processed event_id values and skip duplicates to ensure idempotent handling.

Webhook vs API

APIs send you the data when you request it. For Webhooks, you do not need to make a request. You receive the data when it is available.

Example
If you need to know whether a Applicant has accepted the invitation using APIs, you need to keep polling every few seconds until applicant has accepted the invitation. However, if you are using Webhooks, you can configure a webhook event business.onboarded to receive notifications when a business has accepted an invitation and onboarded.

Webhooks

Applicant Webhooks

Webhook events related to Applicant

Business Webhooks

Webhook events related to Business

Case Webhooks

Webhook events related to Case

Integration Webhooks

Webhook events related to Integrations

Onboarding Webhooks

Webhook events related to Onboarding

Payment Processor Webhooks

Webhook events related to Payment Processor

Risk Webhooks

Webhook events related to risk

Worth Score Webhooks

Webhook events related to Worth Score

Webhooks (Beta)

Sample Payloads

About Webhooks

Example

Event Envelope

Idempotency

Webhook vs API

Example

Webhooks

Applicant Webhooks

Business Webhooks

Case Webhooks

Integration Webhooks

Onboarding Webhooks

Payment Processor Webhooks

Risk Webhooks

Worth Score Webhooks

​Example

​Event Envelope

​Idempotency

​Webhook vs API

​Example

​Webhooks

Applicant Webhooks

Business Webhooks

Case Webhooks

Integration Webhooks

Onboarding Webhooks

Payment Processor Webhooks

Risk Webhooks

Worth Score Webhooks

Example

Event Envelope

Idempotency

Webhook vs API

Example

Webhooks