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

Renew 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/renewInsurancePolicy

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

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

            </tr>

          </thead>

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

              <td class="entry" headers="d463093e100" 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.RenewPolicyIAInputRep record that contains the details of the policy to
                  be renewed.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Outputs

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


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

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

            </tr>

          </thead>

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

              <td class="entry" headers="d463093e149" 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 renewed
                  policy.</p>
              </td>

            </tr>

          </tbody>

        </table>

## Example

Sample Request

{
  "inputs": \[
    {
      "RenewPolicyIAInputRep": {
        "contextId": "d767b27ec095f9f95c5a34299e3bd6f507df23e8d0692dfed17f98dcb5b661b6",
        "policyId": "0YTxx00000001ovGAA",
        "insurancePolicy": {
          "policyName": "Renewed\_Auto\_Policy\_00002",
          "policyNumber": "Renewed Auto Policy 00002",
          "effectiveFromDate": "2025-01-01",
          "effectiveToDate": "2025-12-31"
        },
        "transactionRecord": {
          "name": "Renew 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": "renewInsurancePolicy",
    "errors": null,
    "invocationId": null,
    "isSuccess": true,
    "outcome": null,
    "outputValues": {
      "renewedPolicyId": "0YTSG000000PgX74AK"
    },
    "sortOrder": -1,
    "version": 1
  }
\]