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

# Event types

> Reference of all underwriting webhook event types with payload schemas and example JSON.

### Acceptor application submitted

Triggered when an acceptor application is successfully submitted for processing.

| Field (in `attributes`) | Type   | Description                          |
| :---------------------- | :----- | :----------------------------------- |
| `acceptorApplicationId` | GUID   | Application identifier               |
| `clientId`              | String | Client identifier                    |
| `applicationEventId`    | GUID   | Event tracking ID (unique per event) |
| `organizationId`        | GUID   | Organization identifier              |

```json Example Payload lines expandable theme={null}
{
  "version": "1",
  "eventType": "ACCEPTOR_APPLICATION_SUBMITTED",
  "attemptCount": "1",
  "attributes": {
    "eventType": "ACCEPTOR_APPLICATION_SUBMITTED",
    "acceptorApplicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "clientId": "test-client-123",
    "applicationEventId": "7fa85f64-5717-4562-b3fc-2c963f66afa7",
    "organizationId": "eda0e92b-2dd5-4ea6-b4b8-e22bdb85cb5c",
    "updatedTimestamp": "2026-01-20T10:30:44.0000000Z",
    "actorType": "USER",
    "actorName": "John Doe",
    "currentStatus": "PENDING"
  }
}
```

### Acceptor application approved

Triggered when an acceptor application has been fully approved. Contains the same attribute fields as `ACCEPTOR_APPLICATION_SUBMITTED`.

```json Example Payload lines expandable theme={null}
{
  "version": "1",
  "eventType": "ACCEPTOR_APPLICATION_APPROVED",
  "attemptCount": "1",
  "attributes": {
    "eventType": "ACCEPTOR_APPLICATION_APPROVED",
    "acceptorApplicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "clientId": "test-client-789",
    "applicationEventId": "7fa85f64-5717-4562-b3fc-2c963f66afa7",
    "organizationId": "eda0e92b-2dd5-4ea6-b4b8-e22bdb85cb5c",
    "updatedTimestamp": "2026-01-20T11:15:29.0000000Z",
    "actorType": "SYSTEM",
    "actorName": "Automated Approval System",
    "currentStatus": "APPROVED"
  }
}
```

### Underwriting application updated

Triggered when significant changes are made to an underwriting application (e.g., status change, risk score update).

| Field (in `attributes`) | Type   | Description                                       |
| :---------------------- | :----- | :------------------------------------------------ |
| `applicationId`         | GUID   | Application identifier                            |
| `organizationId`        | GUID   | Organization identifier                           |
| `changes`               | Array  | Array of change objects showing what was modified |
| `applicationEventId`    | GUID   | Event tracking ID (optional)                      |
| `actorType`             | String | Actor type (optional)                             |
| `actorId`               | GUID   | Actor identifier (optional)                       |
| `actorName`             | String | Actor display name (optional)                     |

Each object in the `changes` array contains:

| Field           | Type        | Description                                                   |
| :-------------- | :---------- | :------------------------------------------------------------ |
| `ChangeType`    | String      | Type of change (e.g., `"STATUS_CHANGED"`, `"INFO_FULFILLED"`) |
| `PreviousValue` | String/Null | The old value before the change                               |
| `NewValue`      | String      | The new value after the change                                |
| `Details`       | Object/Null | Additional details about the change (optional)                |

```json Example Payload lines expandable theme={null}
{
  "version": "1",
  "eventType": "UNDERWRITING_APPLICATION_UPDATED",
  "attemptCount": "0",
  "attributes": {
    "eventType": "UNDERWRITING_APPLICATION_UPDATED",
    "applicationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "organizationId": "eda0e92b-2dd5-4ea6-b4b8-e22bdb85cb5c",
    "applicationEventId": "7fa85f64-5717-4562-b3fc-2c963f66afa7",
    "updatedTimestamp": "2026-01-20T12:45:14.0000000Z",
    "actorType": "USER",
    "actorId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
    "actorName": "John Doe",
    "currentStatus": "APPROVED",
    "changes": [
      {
        "ChangeType": "STATUS_CHANGED",
        "PreviousValue": "PENDING",
        "NewValue": "APPROVED",
        "Details": null
      },
      {
        "ChangeType": "INFO_FULFILLED",
        "PreviousValue": "75",
        "NewValue": "82",
        "Details": {
          "FieldName": "riskScore"
        }
      }
    ]
  }
}
```