Using Webhooks

Register webhooks to receive real-time notifications of key events, such as all policy data becoming available after an end-user submits on your Canopy Connect widget.

To register a webhook, specify a web endpoint and select the event types you wish to subscribe to. Canopy Connect's infrastructure will send POST requests to the web endpoint you specify. You can register webhooks from the Settings page on the Canopy Connect dashboard or using the Webhooks API.

Each webhook request represents an event occurring on a specific data Pull. You can use the returned pull_id to fetch the complete information for the data Pull using the GET /pulls/:pullId endpoint.

Event Types

There are 5 event types you can subscribe to:

Event TypeDescription
AUTH_STATUSThis event is triggered when a Pull transitions to a new authentication state.
POLICY_AVAILABLEThis event is triggered when the policy data for an insurance policy becomes available.
POLICIES_AVAILABLEThis event triggers once per Pull, when policy data for all insurance policies is available. Does not include documents.
COMPLETEThis event occurs once per Pull, once all information (including documents) is available.
ERRORThis event is triggered when a Pull encounters an error while running.
MONITORING_RECONNECTThis event is triggered when a Monitoring Pull requires user input to complete authentication.
DATA_UPDATEDThis event is triggered when data on a pull is updated or added.
SERVICING_WAITING_FOR_CONSUMER_CONFIRMATIONThis event is triggered when a ServicingAction has been processed and is waiting for confirmation.