Multi-Root Policy Renewal (POST)

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

Resource

1/connect/insurance/policies/policyId/multi-root/renew

Resource example

1https://yourInstance.salesforce.com/services/data/v66.0/connect/insurance/policies/0YTxx00000000WHGAY/multi-root/renew

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

Available version

66.0

HTTP methods

POST

Request body for POST

JSON example

1{
2 "contextId": "54920265842e1b61496c38b7e2202f6f0aff8123ad2f19fe17ac68f7fc1c60b3",
3 "insurancePolicy": {
4   "policyName": "Demo Test Policy 9",
5   "policyNumber": "test renew policy",
6   "effectiveFromDate": "2025-03-15",
7   "effectiveToDate": "2026-03-15"
8 },
9 "transactionRecord":{
10   "name": "Renew Payment"
11 },
12"additionalFields":{
13      "additionalFieldsList":[
14         {
15            "additionalFieldsMapValue":{
16               "instanceKey":"autoRoot",
17               "fields":{
18                  "Checkbox__c":"true",
19                  "Currency__c":123456,
20                  "Date__c":"2024-11-30",
21                  "DateTime__c":"2024-12-31T01:34:00.000Z",
22                  "Email__c":"testuser@sf.com"
23               }
24            }
25         }
26
27  {
28           "additionalFieldsMapValue":{
29             "instanceKey":"autoDriver",
30              "fields":{
31                 "TextEncr__c":"233345675676",
32                 "Url__c":"https://thisistest.com",
33                  "Time__c":"12:05:00.000Z"
34           }
35        }
36     }
37      ]
38   }
39}

Properties

Name	Type	Description	Required or Optional	Available Version
`additionalFields`	Additional Fields Map Value[]	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
`contextId`	String	Priced context ID of the policy or quote that's used to renew the policy.	Required	63.0
`insurancePolicy`	Insurance Policy Input[]	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[]	JSON structure that's used to override the transaction information.	Optional	63.0

Response body for POST

Multi-Root Policy Asynchronous Response

Insurance Developer Guide

Multi-Root Policy Renewal (POST)