---
schema_version: "1"
id: 96406c69c8bda0ad18ee1bccceb8905d7fb6738b9e1d57d977d04ff6151c37ca
title: Cancel Policy
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/insurance_developer_guide/cancel_policy.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/cancel_policy.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9071a5703f3013485d95857cacefe7db70c29486222eba0c8d43b32534e8dff2
description: The policy cancellation process addresses the termination of an insurance policy before its scheduled expiration date. Common reasons for canceling a policy include not paying the premiums or a direct cancellation request from the policyholder.
---
# Cancel Policy

The policy cancellation process addresses the termination of an insurance policy before its scheduled expiration date. Common reasons for canceling a policy include not paying the premiums or a direct cancellation request from the policyholder.

Make sure you have these details.

- Policy ID of the active insurance policy to be canceled.
- Effective date of cancellation. This date determines when ‌coverage ceases and is a required input for the policy cancellation API.

This diagram outlines a sequence of operations involved in canceling a policy.

![A flow diagram representing the cancel policy user journey.](https://developer.salesforce.com/docs/atlas.en-us.insurance_developer_guide.meta/insurance_developer_guide/dev_guides/insurance/images/cancel_policy.png)

1. Use the policy ID to cancel the policy either by:
    
    - Making a POST request on the [Cancel Insurance Policy](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/connect_resources_cancel_policy.htm "HTML (New Window)") Connect API, or
    - Using the [Cancel Insurance Policy](https://developer.salesforce.com/docs/atlas.en-us.264.0.insurance_developer_guide.meta/insurance_developer_guide/actions_obj_cancel_insurance_policy.htm "HTML (New Window)") invocable action.
    
    You can specify a name for the transaction record that’s created as part of the cancellation process. The transaction record is used for tracking financial implications, such as refunds.
    
    This process returns the details of the policy versions that are canceled, which include the current version and any future-dated versions. Details of any applicable refunds, such as premium refunds and tax refunds, calculated by the system based on the cancellation date and policy terms are also returned by the API.

**Expected Results:**

- The specified policy is marked as Cancelled in Salesforce.
- The policy's effective-to-date field is updated to the day immediately preceding the effective date of cancellation that's specified during the API call.
- Any future-dated policy versions associated with the canceled policy are also automatically canceled.
- Information regarding applicable premium and tax refunds are shown in the API response, which can then be used for downstream financial processing.
- A transaction record is created and linked to the cancellation event.