Endorse Policy

Policy endorsement, also known as Mid-Term Adjustment (MTA), is the process of making modifications to an active insurance policy during its term. Common modifications include adding or removing coverage, or updating policy attributes, such as limits and deductibles. Endorsements usually affect the policy price and create a new policy version instead of updating the existing record. This new version includes the applied changes, along with a recalculated standard premium. It also contains a prorated term premium that’s calculated based on the effective date of the endorsement.

Make sure you have these details.

Policy ID of the active insurance policy to be endorsed.
Pricebook ID is a required input for generating an endorsement quote.
Details of the modifications to be made to the policy, such as specific coverages to add or remove, and new limit amounts.

This diagram outlines the sequence of endorsing a policy, where any changes are initially processed through a quote to assess the pricing impact.

A flow diagram representing the sequence of endorsing a policy based on a quote.

Get Policy Context—Use the policy ID to get the context either by:
- Making a GET request on the Insurance Policy Details Connect API, or
- Using the Get Insurance Policy invocable action.
Create Endorsement Quote—Use the policy context to create the endorsement quote either by:
- Making a POST request on the Insurance Quote Connect API, or
- Using the Create Insurance Quote invocable action.
Specify the contextId and pricebookId during the API call. You can update the header-level fields of the quote, such as the quote name or effective date for the endorsement, by specifying these values as the input parameters during the API call.

A new quote record is generated for the endorsement. After the policyholder confirms the updated quote price, proceed with the next steps in the endorsement workflow.
(Optional)Modify Endorsement Quote—If policyholders want to modify the endorsement quote, make a PATCH request on the Insurance Quote Details Connect API with the required changes.

An updated, price-adjusted context is returned in the response.
Endorse Policy—Use the retrieved context to endorse a policy either by:
- Making a POST request on the Endorse Insurance Policy Connect API, or
- Using the Endorse Insurance Policy invocable action.
You can change the context fields, such as the policy name or policy number, directly during the API call. You can also provide a name for the transaction record that’s created along with the endorsement.

This transaction record documents the financial details and audit information associated with the MTA.

A new endorsed policy version is created.

Expected Results:

A new policy version record is created in Salesforce, which includes the endorsed changes.
A new policy version is created with an updated effective-from date. The effective-to date of the existing policy version is adjusted to an end date just before the new version begins, ensuring continuous but non-overlapping coverage.
The new policy version has the updated premium information, including the new standard premium and the prorated term premium, accurately calculated and stored.
A transaction record is created and linked to the endorsement activity.