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.