---
schema_version: "1"
id: 9d527ad951b1cf1f10937ded7b13fc3121343dcf4ac99f933ee907a06ef588a6
title: Renew Policy
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/renew_policy_without_using_quote.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/renew_policy_without_using_quote.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4209d0bf82bdba8f4aa9ced6119b76847da766b79c7c5db6801b32483cee1a0c
description: Policy renewal extends insurance coverage for an additional term, creating a new policy record. This journey details renewing a policy without using Salesforce quoting, relying on the Rating API for pricing the new term.
---
# Renew Policy

Policy renewal extends insurance coverage for an additional term, creating a new policy record. This journey details renewing a policy without using Salesforce quoting, relying on the Rating API for pricing the new term.

Make sure you have a valid policy ID of the active insurance policy that's due for renewal.

Use the Rating API to generate a price-adjusted context. This price-adjusted context contains the calculated premium and other relevant details that are required to renew the policy. This process bypasses the need for a formal Salesforce Quote record for pricing.

This diagram outlines the sequence of renewing a policy, where any changes are initially processed through the Rating API to generate a price-adjusted context. The context contains the calculated premium and other relevant details that are required to renew the policy. This process bypasses the need for a formal Salesforce Quote record for pricing.

![A flow diagram representing the sequence of renewing a policy by using the Rating API.](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/dev_guides/insurance/images/renew_policy_without_quote.png)

1. **Get Policy Context**—Use the policy ID to get the policy context either by:
    - Making a GET request on the [Insurance Policy Details](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_get_policy.htm "HTML (New Window)") Connect API, or
    - Using the [Get Insurance Policy](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/actions_obj_get_insurance_policy.htm "HTML (New Window)") invocable action.
2. **Generate Price-adjusted Context**—Make a PATCH request on the [Insurance Product Ratings](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_product_rating.htm) Connect API.
    
    The price-adjusted context record contains the premium impact of the proposed modifications.
3. **(Optional)Run Qualification Rules**—If customers want to determine the policyholder’s eligibility for a product, run the qualification rules either by:
    
    - Making a POST request on the [Insurance Quote](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_insurance_quote.htm "HTML (New Window)") Connect API, or
    - Using the [Create Insurance Quote](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/actions_obj_create_quote.htm "HTML (New Window)") invocable action.
    
    Set the saveQuote parameter to false. It doesn't save the quote and returns an updated context with the eligibility details.
4. **Renew Policy**—Use the retrieved context to create a new policy record for the renewal term either by:
    
    - Making a POST request on the [Renew Insurance Policy](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_renew_policy.htm "HTML (New Window)") Connect API, or
    - Using the [Renew Insurance Policy Action](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/actions_obj_renew_insurance_policy.htm "HTML (New Window)") invocable action.
    
    You can change or confirm the policy name, policy number, and effective start and end dates for the renewed policy directly during the API call. Additionally, you can also specify a name for the transaction record that's created along with the renewal record. This transaction record captures the financial details or the audit information related to the renewal record.

**Expected Results:**

- A brand new policy record is created in Salesforce, representing the coverage for the new policy term. The new policy record includes the details, such as any changed terms, coverages, prices, and the new start and end dates.
- A transaction record is created and linked to the new policy.