Skip to main content
Webhooks allow your system to receive real-time notifications when underwriting applications change state or when underwriting actions occur. Using webhooks is the recommended way to monitor application progress asynchronously without polling the API. Underwriting-related webhooks are emitted for key lifecycle events, including application status changes, information requests, and final decisions.
Webhooks are the preferred method for tracking application progress. They provide real-time notifications, reduce API load, and enable responsive integrations that can react immediately to underwriting events.

​
Supported webhook events

Tesouro emits webhooks for the following underwriting events:

​
Application status events

These events track the application as it progresses through the underwriting lifecycle:
  • Application submitted – The application has been submitted for underwriting review
  • Application entered Processing – Automated checks and verifications have begun
  • Application entered Pending – Manual underwriting review is required
  • Application reached a final decision:
    • Approved
    • Declined
    • Withdrawn
ScenarioBen configures webhooks to receive notifications when his keyboard business application reaches a final decision. When the application is approved, the webhook triggers an automated email welcoming him and providing next steps for account activation.

​
Information request events

These events track when underwriters need additional information:
  • Information request created – Underwriter has requested additional information (status: REQUESTED)
  • Information request fulfilled – The requested information has been provided (status: FULFILLED)
These events allow your system to react to underwriting progress and take appropriate actions, such as notifying users or updating internal workflows.
ScenarioWhen an information request is created for Ben’s application, a webhook notification triggers an automated email to Ben with instructions on what documents to upload. When Ben fulfills the request, another webhook confirms receipt and notifies the underwriting team.

​
Webhook payload structure

Every webhook follows a consistent top-level structure:

​
Top-level fields

​
Common attribute fields

All events include these fields inside the attributes object: Optional actor information is included when an event is triggered by a specific entity:
Payload Structure