Skip to main content

Application Events

The following webhook events are triggered during the application lifecycle:

Application Events

EventDescription
application.createdTriggered when a new application is created.
application.approvedTriggered when an application is approved. A Customer resource is created at this point.
application.deniedTriggered when an application is denied.
application.awaitingDocumentsTriggered when an application requires additional documents to proceed.
application.pendingReviewTriggered when an application is pending manual review by Unit.
application.canceledTriggered when an application is canceled.
EventDescription
customer.createdTriggered when a Customer resource is created after an application is approved.
document.approvedTriggered when an application document is approved.
document.rejectedTriggered when an application document is rejected.

Listening for Events

To receive these events, you need to set up a webhook endpoint. See the Webhooks documentation for more information on configuring webhooks.

Example Event Payload

When an application is approved, you will receive an event similar to:

{
"data": [
{
"id": "1234",
"type": "application.approved",
"attributes": {
"createdAt": "2023-01-15T10:30:00.000Z"
},
"relationships": {
"application": {
"data": {
"type": "individualApplication",
"id": "10001"
}
},
"customer": {
"data": {
"type": "individualCustomer",
"id": "20001"
}
}
}
}
]
}

Event Flow

  1. application.created - Initial application submission
  2. application.awaitingDocuments (if needed) - Documents required
  3. document.approved / document.rejected - Document processing
  4. application.pendingReview (if needed) - Manual review required
  5. application.approved or application.denied - Final decision
  6. customer.created - Customer resource created (on approval)