---
schema_version: "1"
id: 383ef7c77dd5b20209d128f43b49cb6e7efc93cc49e34b3ba3cda0e8c0e0305f
title: Renew Insurance Policy (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_renew_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_renew_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: f247b58bbc758c174f78de0cbc9f9f09c1c393bebe80ef4a68eb6a270b795707
description: Use the context ID of an existing policy to renew the policy. Modify the renewal date and also add optional fields and additional information in the request body.
---
# Renew Insurance Policy (POST)

Use the context ID of an existing policy to renew the policy. Modify the renewal date and also add optional fields and additional information in the request body.

If you want to calculate billing during an insurance policy renewal process, specify billingRecord details in the API request, and make sure that Career Billing is enabled in your org.

## Resource

{policyId} is a placeholder.

/connect/insurance/policies/{policyId}/renew

## Resource Example

Replace {yourInstance} with the My Domain name of your Salesforce org.

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/policies/0YTxx00000000WHGAY/renew

## Available Version

63.0

## HTTP Methods

POST

## Request Body for POST

### JSON Example

{
 "contextId": "54920265842e1b61496c38b7e2202f6f0aff8123ad2f19fe17ac68f7fc1c60b3",
 "insurancePolicy": {
   "policyName": "Demo Test Policy 9",
   "policyNumber": "test renew policy",
   "effectiveFromDate": "2025-03-15",
   "effectiveToDate": "2026-03-15"
 },
 "transactionRecord":{
   "name": "Renew Payment"
 },
"billingRecord": {
    "billDayOfMonth": 15,
    "billToContact": "003xx000000001aEAA"
  },
"additionalFields":{
      "additionalFieldsList":\[
         {
            "additionalFieldsMapValue":{
               "instanceKey":"autoRoot",
               "fields":{
                  "Checkbox\_\_c":"true",
                  "Currency\_\_c":123456,
                  "Date\_\_c":"2024-11-30",
                  "DateTime\_\_c":"2024-12-31T01:34:00.000Z",
                  "Email\_\_c":"testuser@sf.com"
               }
            }
         }

  {
           "additionalFieldsMapValue":{
             "instanceKey":"autoDriver",
              "fields":{
                 "TextEncr\_\_c":"233345675676",
                 "Url\_\_c":"https://thisistest.com",
                  "Time\_\_c":"12:05:00.000Z"
           }
        }
     }
      \]
   }
}

### Properties

| Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| additionalFields | [Additional Fields Map Value](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_additional_fields_map_value.htm "Input representation for the AdditionalFieldsMapValue wrapper object that's used as child wrapper of AdditionalFieldsMap.")\[\] | JSON structure that’s used to add custom or standard fields to the InsurancePolicy, InsurancePolicyAsset, InsurancePolicyCoverage, and InsurancePolicyParticipant objects. The values for additionalFields take precedence over the context or the insurancePolicy JSON. This is applicable only for the endorsed policy version. Address and Geolocation field types are not supported as additional fields. | Optional | 63.0 |
| billingRecord | [Insurance Policy Billing Details](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_insurance_policy_billing_info_input.htm "Input representation for insurance policy billing.") | Billing details to calculate billing when renewing the policy. | Optional | 67.0 |
| contextId | String | Priced context ID of the policy or quote that's used to renew the policy. | Required | 63.0 |
| insurancePolicy | [Insurance Policy Input](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_insurance_policy_input.htm "Input representation of insurance policy details.")\[\] | JSON structure that’s used to renew the policy. It contains fields and values from the Insurance Policy object. | Optional | 63.0 |
| transactionRecord | [Insurance Policy Transaction Input](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_insurance_policy_transaction_input.htm "Input representation of the insurance policy transaction details.") \[\] | JSON structure that's used to override the transaction information. | Optional | 63.0 |

## Response Body for POST

[Policy](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_policy_output.htm "Output representation of policy details.")