Events

This is the catalog of webhook events. Subscribe a webhook to an event by adding the event's type to its events list. Every delivered payload is a JSON object whose type field identifies the event, plus the common eventId and requestId fields described in the Overview.

Event	Description
application.status.changed.v1	Sent when an application's status changes.
org.status.changed.v1	Sent when an organization's status changes.

application.status.changed.v1

Sent when an application's status changes.

Field	Type	Description
eventId	string	Stable id of this delivery; identical across retries (use it to deduplicate).
requestId	string	Id of the individual delivery attempt; changes on every retry.
type	string	Always "application.status.changed.v1".
applicationId	string	The id of the application whose status changed.
orgId	string | null	The id of the linked organization, or null until the application is approved.
status	string	The new status (see below).
previousStatus	string | null	The status before the change, or null for the application's first status.
occurredAt	string	ISO-8601 timestamp of when the change occurred.

status and previousStatus are one of:

Status	Meaning
draft	The application was opened and is being filled out.
submitted	The application was submitted by the merchant and is ready for review.
approved	The application was reviewed and approved by underwriting.
declined	The application was reviewed and declined by underwriting.

Example payload:

{
  "eventId": "WebhookRequest#2cVQF8s0u9c2bq5b3pTn1mY7kde",
  "requestId": "2dWRg9t1v0d3cr6c4qUo2nZ8lef",
  "type": "application.status.changed.v1",
  "applicationId": "Application#2cVQF8s0u9c2bq5b3pTn1mY7kde",
  "orgId": null,
  "status": "submitted",
  "previousStatus": "draft",
  "occurredAt": "2026-06-25T17:42:03.118Z"
}

org.status.changed.v1

Sent when an organization's status changes.

Field	Type	Description
eventId	string	Stable id of this delivery; identical across retries (use it to deduplicate).
requestId	string	Id of the individual delivery attempt; changes on every retry.
type	string	Always "org.status.changed.v1".
orgId	string	The id of the organization whose status changed.
status	string	The new status (see below).
previousStatus	string | null	The status before the change, or null for the org's first status.
occurredAt	string	ISO-8601 timestamp of when the change occurred.

status and previousStatus are one of:

Status	Meaning
Onboarding	The organization is being onboarded and is not yet fully active.
Healthy	The organization is active and in good standing.
Unhealthy	The organization is active but in a degraded or at-risk state.
Suspended	The organization has been suspended and cannot transact.
Closed	The organization has been permanently closed.

Example payload:

{
  "eventId": "WebhookRequest#2cVQF8s0u9c2bq5b3pTn1mY7kde",
  "requestId": "2dWRg9t1v0d3cr6c4qUo2nZ8lef",
  "type": "org.status.changed.v1",
  "orgId": "Org#2cVQF8s0u9c2bq5b3pTn1mY7kde",
  "status": "Healthy",
  "previousStatus": "Onboarding",
  "occurredAt": "2026-06-25T17:42:03.118Z"
}