---
schema_version: "1"
id: 08488ad3e6a20977263f019e5a8003a048d3df25039969275f5b407b9704f239
title: Renew Contract (POST)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_renew_contract.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_renew_contract.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: b95fbfe75891a203951d2ced9ccc7dfb634a43b333d7da82087ba5d4c13bca6d
description: Create a renewed insurance contract from a renewal quote, carrying forward the applicable contract details and line items for the next coverage term.
---
# Renew Contract (POST)

Create a renewed insurance contract from a renewal quote, carrying forward the applicable contract details and line items for the next coverage term.

## Resource

/connect/insurance/contracts/actions/renew

## Resource Example

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

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/contracts/actions/renew

## Available Version

68.0

## HTTP Methods

POST

## Request Body for POST

### JSON Example

{
  "quoteId": "0Q0xx0000004CtoCAE",
  "renewalDate": "2026-03-11",
  "contractEndDate": "2027-03-11",
  "contractTerm": 12,
  "targetContractId": "800xx0000004C92AAE",
  "additionalFields": {
    "insuranceContractItemList": \[
      {
        "entity": "Contract",
        "fields": {
          "data": \[
            {
              "key": "Description",
              "value": "Renewed for FY2026"
            }
          \]
        }
      },
      {
        "entity": "InsuranceContract",
        "fields": {
          "data": \[
            {
              "key": "myCustomPickList\_\_c",
              "value": "Alive"
            },
            {
              "key": "EnrollmentEndDate",
              "value": "2022-01-20"
            },
            {
              "key": "EnrollmentStartDate",
              "value": "2021-01-20"
            }
          \]
        }
      },
      {
        "entity": "ContractGroupPlan",
        "productPath": "dentalBasic",
        "fields": {
          "data": \[
            {
              "key": "EnrollmentEndDate",
              "value": "2025-12-31"
            }
          \]
        }
      }
    \]
  }
}

### Properties

| Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| additionalFields | [Insurance Contract Item Input](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_requests_insurance_contract_item.htm "Input representation of the details, such as object, product path, and field values to extend a contract when issuing it from a quote.")\[\] | List of additional fields to apply to contract objects when the renewed contract is created. | Optional | 68.0 |
| contractEndDate | String | End date of the renewed contract. Specify the date in the yyyy-MM-dd format. | Required | 68.0 |
| contractTerm | Integer | Duration of the renewed contract in months. The default value is 12. | Optional | 68.0 |
| quoteId | String | ID of the quote from which you want to create the renewed contract. | Required | 68.0 |
| renewalDate | String | Date that the renewed contract term starts. Specify the date in the yyyy-MM-dd format. | Required | 68.0 |
| targetContractId | String | ID of the existing contract that the renewal is based on, when you need to identify the prior contract explicitly. | Optional | 68.0 |

## Response Body for POST

[Contract Renewal Response](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_insurance_contract_renewal.htm "Output representation of the details when a renewed group benefits contract is created from a quote.")