> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rollfi.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Webhooks

* **Overview:** This webhook reflects changes in a company’s compliance and verification journey. It indicates when KYB review begins, progresses, completes successfully, or requires intervention before the company can fully operate on the platform.

## 🔹 Company KYB Status Webhook

### Events

* `company.kybstatus.insert` — emitted when a company record is first created. The payload returns kycStatus of `new`, confirming the company was saved successfully.
* `company.kybstatus.update` — emitted whenever the company’s kycStatus value changes after creation.

### Statuses

| Status    | Description                                                                                                         |
| --------- | ------------------------------------------------------------------------------------------------------------------- |
| `new`     | The company has been created and KYB has not yet been initiated.                                                    |
| `pending` | KYB is currently being processed by our KYB provider. This process may take a few days.                             |
| `passed`  | KYB has passed, unlocking the system’s full functionality.                                                          |
| `failed`  | KYB has failed. Rollfi will reach out with an explanation so any issues can be resolved and KYB can be resubmitted. |

### Example Payload

```json theme={null}
{
  "trigger": {
    "eventId": "d2a34d4a-8e7b-4f9f-9d3f-1b9d6d7f6c10",
"eventType": "company.kybstatus.update",
    "eventTimeStamp": "01/06/2026 18:59:16"
  },
  "payload": [
    {
      "Company": [
        {
          "company": "Acme Operations LLC",
          "companyID": "9F3A1C7E-5B22-4D91-8E6A-2C9E47B8A103",
          "businessWebsite": "https://www.acme-operations.com",
          "registration": {
            "isTermsAccepted": true
          },
          "CompanyLocations": [],
          "KYBInformations": [],
          "kycStatus": "pending",
          "BankAccounts": [],
          "PaySchedules": [],
          "StateTaxRegistrations": []
        }
      ]
    }
  ]
}
```