---
schema_version: "1"
id: 6cb3af17b968dc5c45a272d4427948f59aa1704e5fdf6f78dca8bac76b078651
title: Endorse 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_endorse_insurance_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/actions_obj_endorse_insurance_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: c20dbc386d0cb5f4d6c323452bc61a1332d9b04559a9fe5f47de06d25f66a7dc
description: Endorse an insurance policy by using a set of user inputs that represent policy details.
---
# Endorse Insurance Policy Action

Endorse 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/endorseInsurancePolicy

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="d460512e96">Input</th>

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

            </tr>

          </thead>

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

              <td class="entry" headers="d460512e99" 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.EndorsePolicyIAInputRep record that contains the
                  details of the policy to be endorsed. To calculate billing,
                  specify <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="d460512e148">Output</th>

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

            </tr>

          </thead>

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

              <td class="entry" headers="d460512e151" 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 endorsed
                  insurance policy.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Example

Sample Request.

{ 
"inputs": \[
       {
           "EndorsePolicyIAInputRep": {
               "contextId": "5dbc40312f69b2d8cb4e7042a700d06f32fc5b9df7de3eabc94aa19a66ed77b3",
               "policyId": "0YTxx00000001IfGAI",
               "effectiveDate" : "2024-06-06",
               "insurancePolicy": {
                   "policyName": "Endorsed Test Auto Ins policy",
                   "policyNumber": "PLC5678987"
               },
               "transactionRecord": {
                   "name": "Endorsed 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": "endorseInsurancePolicy",
    "errors": null,
    "invocationId": null,
    "isSuccess": true,
    "outcome": null,
    "outputValues": {
      "endorsedPolicyId": "0YTSG000000PgVV4A0"
    },
    "sortOrder": -1,
    "version": 1
  }
\]