company.updated - Rain

initial release

company.updated webhook

Added the company.updated webhook. This webhook is triggered when a company’s compliance/application status changes, such as when a KYB application is approved, denied, or requires additional information.

Payload Fields

Field	Type	Description
`id`	`string`	Webhook ID
`resource`	`string`	Always `"company"`
`action`	`string`	Always `"updated"`
`version`	`string`	The webhook version
`eventReceivedAt`	`string` (optional)	ISO 8601 timestamp of when the event was received by Rain
`body.id`	`string`	The company ID
`body.name`	`string`	Company name
`body.applicationStatus`	`string` (optional)	Current application/compliance status (see values below)
`body.applicationCompletionLink`	`object` (optional)	Link for the company to complete their application
`body.applicationCompletionLink.url`	`string`	The URL to complete the application
`body.applicationCompletionLink.params.userId`	`string`	The company ID parameter
`body.applicationCompletionLink.params.signature`	`string`	Signature parameter for verification
`body.applicationExternalVerificationLink`	`object` (optional)	Deprecated in favor of `applicationCompletionLink`
`body.applicationReason`	`string`	Comma-separated rejection labels from the compliance provider (empty string when no rejections)

Application Status Values

Status	Description
`approved`	Application has been approved
`pending`	Application is pending review
`needsInformation`	Additional information is required
`needsVerification`	Additional verification is required
`manualReview`	Application is under manual review
`denied`	Application has been denied
`locked`	Company account is locked
`canceled`	Application has been canceled
`notStarted`	Application has not been started

Example Payload (Approved)

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": "company",
    "action": "updated",
    "version": "1.0.0",
    "eventReceivedAt": "2026-01-27T15:30:00.000Z",
    "body": {
        "id": "company_abc123",
        "name": "Acme Corp",
        "applicationStatus": "approved",
        "applicationReason": ""
    }
}

Example Payload (Needs Information)

{
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "resource": "company",
    "action": "updated",
    "version": "1.0.0",
    "eventReceivedAt": "2026-01-27T15:30:00.000Z",
    "body": {
        "id": "company_abc123",
        "name": "Acme Corp",
        "applicationStatus": "needsInformation",
        "applicationCompletionLink": {
            "url": "https://kyc.example.com/complete",
            "params": {
                "userId": "company_abc123",
                "signature": "abc123signature"
            }
        },
        "applicationExternalVerificationLink": {
            "url": "https://kyc.example.com/complete",
            "params": {
                "userId": "company_abc123",
                "signature": "abc123signature"
            }
        },
        "applicationReason": "documentPageMissing, badPhotoQuality"
    }
}