---
schema_version: "1"
id: 83df279686b5f13d0e653fce4e065f498bfe48bcc1ccf44401ac78808cca1fbd
title: Multi-Root Policy Endorsement (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_insurance_multi_root_endorsement_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_insurance_multi_root_endorsement_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 2471c543a6651194546018a1d0337581f0c89e05a6ae03af65a93bc9a6102b62
description: Asynchronously endorse a multi-root insurance policy along with its child policies.
---
# Multi-Root Policy Endorsement (POST)

Asynchronously endorse a multi-root insurance policy along with its child policies.

If you want to calculate billing during multi-root insurance policy endorsement, 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/endorse

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

## Available Version

66.0

## HTTP Methods

POST

## Path Parameter for POST

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

## Request Body for POST

### JSON Example

{
  "contextId": "54920265842e1b61496c38b7e2202f6f0aff8123ad2f19fe17ac68f7fc1c60b3",
  "effectiveDate": "2024-01-01",
  "insurancePolicy": {
    "policyName": "p2\_endorse\_name",
    "policyNumber": "p2\_endorse\_number"
  },
  "transactionRecord": {
    "name": "New Endorsement"
  },
 "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 endorsing the policy. | Optional | 67.0 |
| contextId | String | Context ID of the quote that’s used for endorsement. | Required | 63.0 |
| effectiveDate | String | Date from when the endorsed policy version is effective. | 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 overrides the name and policy number of the endorsed policy version. | 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 overrides 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.")