---
schema_version: "1"
id: 7769c213916020210b3a82438c701c76f0ac8ba4653ea6eab733e9aee9fec8c0
title: Issue 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_issue_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_issue_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8804b177497ce0e76e14a1b7306bf7e7d1bcb64234a61a64bd76067b57b7b049
description: Use the context ID provided in the request body to generate a new insurance policy.
---
# Issue Insurance Policy (POST)

Use the context ID provided in the request body to generate a new insurance policy.

If you want to calculate billing during an 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

## Resource Example

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

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

## Available Version

63.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

[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.")