---
schema_version: "1"
id: 250a6c92db089c8c0b6ae6caff52ef50a0e8008b2974f5934c1eb17ce7456fe4
title: Multi-Root Policy Renewal (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_insurance_policy_multi_root_renew.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_insurance_policy_multi_root_renew.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 6a7d9b6ba5da09ce179c81ba74825b1861329841e75690aab8905d8e0ff00e67
description: Asynchronously renew a multi-root insurance policy, create renewed records for the parent policy and the associated child policies.
---
# Multi-Root Policy Renewal (POST)

Asynchronously renew a multi-root insurance policy, create renewed records for the parent policy and the associated child policies.

If you want to calculate billing during multi-root 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}/multi-root/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/multi-root/renew

## Available Version

66.0

## HTTP Methods

POST

## Path Parameter for POST

| Parameter Name | Type | Description | Required or Optional |
| --- | --- | --- | --- |
| policyId | String | ID of the policy that must be renewed along with its associated child policies. | Required |

## 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

[Multi-Root Policy Asynchronous Response](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_policy_async.htm "Details of the multi-root policy that's processed asynchronously.")