---
schema_version: "1"
id: 65050b61c146aeb8990008d071ae2c7c431582fdb94f3990dd73faea06ba540c
title: Endorse 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_endorse_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_endorse_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 740b059182d112072a463ae2e3bd1fd3d60dc148e25505a320af4ed44b60e2d8
description: Endorse the latest version of the insurance policy based on the context ID and effective date. You can also include other optional fields and additional details in the request body.
---
# Endorse Insurance Policy (POST)

Endorse the latest version of the insurance policy based on the context ID and effective date. You can also include other optional fields and additional details in the request body.

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

## Available Version

63.0

## HTTP Methods

POST

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

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