Added

Policy Lifecycle Webhooks

New policy lifecycle webhooks for real-time policy event updates: endorsements, renewals, reinstatements, and cancellations.

All four of these new webhooks will have the same payload (except for type of course).

{
  "specversion": "1.0",
  "id": "uuid",
  "time": "ISO8601 Timestamp",
  "source": "root.com/policy",
  "type": "com.root.policy...", // See below
  "datacontenttype": "application/json",
  "data": {
    "policyId": "uuid",
    "policyNumber": "string",
    "effectiveTimestamp": "ISO8601 Timestamp"
  }
}

com.root.policy.canceled.v2 Policy Canceled

Released:[2024-11-14]

Occurs when a policy is canceled and coverage concludes.

com.root.policy.endorsed.v2 Policy Endorsed

Released:[2024-11-14]

Occurs each time a policy is changed, such as different limits or deductible or a new vehicle added.

com.root.policy.reinstated.v2 Policy Reinstated

Released:[2024-11-14]

Occurs when a policy is reinstated after a period of lapse.

com.root.policy.renewed.v2 Policy Renewed

Released:[2024-11-14]

Occurs when a new policy term begins after the conclusion of the prior policy term. The policyNumber will remain consistent between the two terms.

Notes:

  • effectiveTimestamp
    • May be future dated.
    • May be later than time.