---
schema_version: "1"
id: bf383728551d1d843883b4788c509e74dc72919ac92ee4c5dd821915e9d405e1
title: Multi-Root Policy Issuance (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_multi_root_issue_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_multi_root_issue_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 531cc6bef24aaa6803ddfa5b6c993c7eab3d3f905f01435520a086e3006660ec
description: Asynchronoulsy create a multi-root insurance policy along with its child policies. A multi-root policy includes multiple child policies of different product types under a single parent policy.
---
# Multi-Root Policy Issuance (POST)

Asynchronoulsy create a multi-root insurance policy along with its child policies. A multi-root policy includes multiple child policies of different product types under a single parent policy.

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

## Resource

/connect/insurance/policies/multi-root

## Resource Example

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

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/policies/multi-root

## Available Version

66.0

## HTTP Methods

POST

## Request Body for POST

### JSON Example

{
    "contextId": "3561319f267fd53380bc38c049a01c8089876e833a321860766d35a9c40b67df",
    "insurancePolicy": {
        "policyName": "Mr. Bret Lees Policy",
        "policyNumber": "Policy-Bret-OneYear",
        "effectiveFromDate": "2024-01-01",
        "effectiveToDate": "2024-10-31"
    },
    "transactionRecord": {
        "name": "New Policy"
    },
"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. Address and Geolocation field types are not supported as additional fields. Add the SourceQuoteId standard field to the additionalFields option when the context ID in the input JSON for the Issue Insurance Policy API or the Multiroot Issue Inurance Policy API is generated by the Create Insurance Quote API. | 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 issuing the policy. | Required if Career Billing is enabled in your org | 67.0 |
| contextId | String | Context ID of the policy or quote that’s used to create 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 create 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 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.")