First Leeward

Webhook event

Company Status Updated

POSTCOMPANY_STATUS_UPDATED

Fired when a company status changes (e.g., KYB approved, rejected, restricted).

Body

application/json

idstringrequired

Unique event identifier for idempotency

typestringrequired

Webhook event type

Available options:COMPANY_STATUS_UPDATED
dataobjectrequired
Show child attributes
idstring<uuid>required

Unique company identifier

namestringrequired

Legal company name

registrationNumberstring | nullrequired

Business registration number (populated from KYB)

countrystring | nullrequired

ISO 3166-1 alpha-2 country code

statusstringrequired

Company compliance status

Available options:CREATEDPENDINGIN_REVIEWACTION_REQUIREDACTIVEREJECTEDRESTRICTED
isDeactivatedbooleanrequired

Whether the verification provider has deactivated the company. Orthogonal to status: a deactivated company stays readable and keeps its last KYB verdict.

createdAtstringrequired

ISO 8601 timestamp of creation

updatedAtstringrequired

ISO 8601 timestamp of last update

Response

200Webhook received successfully. Return any 2xx status to acknowledge.