---
schema_version: "1"
id: 529f47086f9cc64a5bb93b55176ad6bb131e034d2dd87a8e01433ae47684b31f
title: Cancel Policy (PATCH)
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/connect_resources_brokerage_cancel_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_brokerage_cancel_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: af5eed151336ff79a523d65153ee16e81a27a945aa16006b0fe756da16a430ef
description: Cancel an insurance policy.
---
# Cancel Policy (PATCH)

Cancel an insurance policy.

## Resource

{policyId} is a placeholder.

/connect/insurance/brokerage/policies/{policyId}/cancel

## Resource Example

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

https://{yourInstance}.salesforce.com/services/data/v68.0/connect/insurance/brokerage/policies/0YTxx0000000001GAA/cancel

## Available Version

67.0

## HTTP Methods

PATCH

## Request Parameters for PATCH

| Parameter Name | Type | Description | Required or Optional |
| --- | --- | --- | --- |
| policyId | Id | ID of the insurance policy to cancel. The key prefix is 0YT. | Required |

## Request Body for PATCH

### JSON Example

{
    "cancellationEffectiveDate": "2026-07-01",
    "cancellationReason": "Non-payment",
    "status": "Cancelled"
}

### Properties

| Name | Type | Description | Required or Optional | Available Version |
| --- | --- | --- | --- | --- |
| cancellationEffectiveDate | String | Date after which the policy is no longer valid. Use the format YYYY-MM-DD. | Required | 67.0 |
| cancellationReason | String | Reason for canceling the insurance policy. | Optional | 67.0 |
| status | String | Target status of the canceled policy, such as Canceled. | Optional | 67.0 |

## Response Body for PATCH

[Insurance Policy Cancellation Response](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/connect_responses_insurance_policy_cancellation_output.htm "Output representation details of the cancel policy request.")