Mitigation Webhooks

Mitigation Lifecycle

Mitigations start in a Requested state upon successful creation via API. Modern Insurer matches the Requested Mitigation with a qualified contractor to complete the assignment.

When the contractor accepts the assignment, the Mitigation moves to an Assigned state. At this point in the process, the contractor is asked to provide an estimate. When the contractor provides an estimate, the Mitigation moves to an Estimated state. A webhook event is delivered to your system notifying you that the estimate has been submitted. You then have the option to approve or reject the estimate with the Approve mitigation estimate and Reject mitigation estimate endpoints, respectively.

When you approve the estimate, the contractor is allowed to schedule the assignment. When that occurs, the Mitigation moves to a Scheduled state. The contractor then completes the assignment and the Mitigation moves to Completed.

Mitigation Lifecycle Diagram

Webhook Events

EventType	Description
mitigation.assigned	The assigned contractor has accepted the mitigation assignment.
mitigation.estimated	The assigned contractor has submitted an estimate for the mitigation work.
mitigation.scheduled	The assigned contractor has scheduled the work to be completed.
mitigation.completed	The mitigation has been successfully completed by the assigned contractor.

Sample Payloads

mitigation.assigned

{
  "eventType": "mitigation.assigned",
  "mitigationId": "68161ead3c125ad6704c06b5",
  "policyNumber": "abc-123",
  "propertyId": "6814e72c3c125ad6704c0349"
}

mitigation.estimated

{
  "eventType": "mitigation.estimated",
  "mitigationId": "68161ead3c125ad6704c06b5",
  "estimateId": "68161ed03c125ad6704c06e7",
  "propertyId": "6814e72c3c125ad6704c0349",
  "totalCost": 132,
  "estimateDocument": {
  	"filename": "estimate-68161ed03c125ad6704c06e7-1746280145411.pdf",
  	"uploadDate": "2025-05-03T13:49:05.714Z",
  	"url": "https://mxoiflstnghwqac9.public.blob.vercel-storage.com/estimate-68161ed03c125ad6704c06e7-1746280145411-X86XAJwwy5QLvsUEyNBweO1CrDRr3O.pdf"
	}   
}

mitigation.scheduled

{
	"eventType": "mitigation.scheduled",
	"mitigationId": "6814ef963c125ad6704c054e",
  "policyNumber": "abc-123",
  "propertyId": "6814e72c3c125ad6704c0349",
  "scheduledDate": "2025-05-14T00:00:00.000Z"
}

mitigation.completed

{
  "eventType": "mitigation.completed",
	"mitigationId": "6814ef963c125ad6704c054e",
  "policyNumber": "abc-123",
  "propertyId": "6814e72c3c125ad6704c0349",
  "completionDocument": {
  	"filename": "2010custbill03042025.pdf",
		"uploadDate": "2025-05-02T16:21:56.575Z",
    "url": "https://mxoiflstnghwqac9.public.blob.vercel-storage.com/2010custbill03042025-vk7i4YVFSdL1Upecu1lW4c3rBE9pog.pdf"
  }
}