---
schema_version: "1"
id: 60201066d6eeb333e20bacdbd1642d187c75a665e097bba44b3c610284640b89
title: Issue Insurance Policy Action
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/actions_obj_issue_insurance_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/actions_obj_issue_insurance_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 1f48f980d5965f8a309fe9caeaa04d6db51160de70a79c44ad0f2ccce8efaf25
description: Issue an insurance policy by using a set of user inputs that represent policy details.
---
# Issue Insurance Policy Action

Issue an insurance policy by using a set of user inputs that represent policy details.

This action is available in API version 63.0 and later.

## Supported REST HTTP Methods

**URI**: /services/data/vXX.X/actions/standard/issueInsurancePolicy

Where XX.X is the latest API version.

**Formats**: JSON

**HTTP Methods**: POST

**Authentication**: Authorization: Bearer TOKEN

Where TOKEN is your OAuth access token.

## Inputs

<table class="featureTable sort_table" summary="">


          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d461624e96">Input</th>

              <th class="featureTableHeader  " id="d461624e99">Details</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d461624e96" data-title="Input"><samp class="codeph nolang">issuePolicyIAInputRep</samp></td>

              <td class="entry" headers="d461624e99" data-title="Details">
                <strong class="ph b">Type</strong>
                <p class="p">Apex-defined</p>
                <p class="p"><strong class="ph b">Description</strong></p>
                <p class="p">An Apex
                  ConnectApi.IssuePolicyIAInputRep record that contains the
                  details of the policy to be issued. To calculate billing,
                  provide <samp class="codeph nolang">billingRecord</samp>
                  details if Career Billing is enabled in your org.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Outputs

<table class="featureTable sort_table" summary="">


          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d461624e148">Output</th>

              <th class="featureTableHeader  " id="d461624e151">Details</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d461624e148" data-title="Output"><samp class="codeph nolang">issuedPolicyId</samp></td>

              <td class="entry" headers="d461624e151" data-title="Details">
                <strong class="ph b">Type</strong>
                <p class="p">String</p>
                <strong class="ph b">Description</strong>
                <p class="p">ID of the issued
                  policy.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Example

Sample Request

{
"inputs": \[
       {
           "IssuePolicyIAInputRep": {
               "contextId": "c98a08a0a9725b7a7d42c35d02e49d80c77a5aae4ea687b0bf09a7997d2af3d3",
               "insurancePolicy": {
                   "policyName": "Test Auto Ins policy Via REST",
                   "policyNumber": "PLC5678987",
                   "effectiveFromDate" : "2024-01-01",
                   "effectiveToDate" : "2024-12-31",
                   "standardFee": "1011"
               },
               "transactionRecord": {
                   "name": "Sold Policy Transaction"
               },
               "billingRecord": {
                   "billDayOfMonth": 15,
                    "billToContact": "003xx000000001aEAA"
              },
               "additionalInput": \[
                   {
                       "instanceKey": "AutoBundle2",
                       "additionalFieldsList": \[
                           {
                               "key":"AssetDescription\_\_c",
                               "value": "Test\_AssetDescription\_\_c"
                           },
                           {
                               "key":"SourceSystem",
                               "value": "Test\_SourceSystem"
                           }
                       \]
                   },
                   {
                       "instanceKey": "AutoDriver",
                       "additionalFieldsList":\[
                           {
                               "key": "ParticipantName",
                               "value": "Test\_ParticipantName"
                           },
                           {
                               "key":"Participant\_Hometown\_\_c",
                               "value": "Test\_Participant\_Hometown\_\_c"
                           }
                       \]
                   },
                   {
                       "instanceKey": "AutoRoot",
                       "additionalFieldsList": \[
                           {
                               "key": "Primary\_Policy\_Holder\_\_c",
                               "value": "Test\_Primary\_Policy\_Holder\_\_c"
                           },
                           {
                               "key":"PolicyDescription",
                               "value": "Test\_PolicyDescription"
                           }
                       \]
                   },
                   {
                       "instanceKey": "AutoBundle2\_AutoComp1",
                       "additionalFieldsList": \[
                           {
                               "key": "Coverage\_Description\_\_c",
                               "value": "Test\_Coverage\_Description\_\_c"
                           },
                           {
                               "key": "Description",
                               "value": "Test\_Description"
                           }
                       \]
                   }
               \]
           }
       }
   \]
}

Sample Response

\[
  {
    "actionName": "issueInsurancePolicy",
    "errors": null,
    "invocationId": null,
    "isSuccess": true,
    "outcome": null,
    "outputValues": {
      "issuedPolicyId": "0YTSG000000PgSH4A0"
    },
    "sortOrder": -1,
    "version": 1
  }
\]