---
title: "POST Unsubscribe Contacts"
method: POST
path: "/partner/accounts/{encoded_account_id}/contacts/unsubscribe"
tags: ["Technology Partners"]
---

# POST Unsubscribe Contacts

`POST /partner/accounts/{encoded_account_id}/contacts/unsubscribe`

## Request

- Base URL: `https://api.cc.email/v3`
- URL: `https://api.cc.email/v3/partner/accounts/{encoded_account_id}/contacts/unsubscribe`
- Auth: OAuth 2 and API key in header `x-api-key`
  - Implicit: `https://v3api-partner.auth.us-east-1.amazoncognito.com/oauth2/token`

Use to unsubscribe contacts from partner client accounts. Identify the contacts to unsubscribe using the `email_address` parameter. To unsubscribe a single contact from all partner client accounts, specify the contacts `email_address` and set the `global_unsubscribe` parameter to `true`.

## Path parameters

- `encoded_account_id` string, required

## Request body

- object
  - `email_addresses` string[]: Array of email addresses to unsubscribe.
  - `update_source` 'Account' | 'Contact' | 'System', required: Required parameter to specify the update source performing the unsubscribe.
  - `opt_out_reason` string: Optional parameter to specify the reason for the unsubscribe.
  - `delete_contacts` boolean: Optional parameter to specify if the contact(s) should be soft-deleted as part of the unsubscribe.
  - `global_unsubscribe` boolean: Optional parameter to specify if the contact's email address should be unsubscribed from all partner child accounts. When specified only a single email address in the `email_addresses` array can be specified.

## Response `200`

Contacts were successfully unsubscribed

- PartnerUnsubscribeResponse: Response indicating the number of contacts that were successfully unsubscribed.
  - `unsubscribed_count` integer: The number of contacts that were successfully unsubscribed.

## Other responses

- `400`: Bad request. Either the JSON was malformed or there was a data validation error.
- `401`: The Access Token used is invalid.
- `403`: Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404`: The requested resource was not found.
- `406`: Unsupported Media Type.
- `500`: There was a problem with our internal service.

## Changes

- **2026-08-04** `4b4a534c818d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cc/apis/appconnect-v3/changes/partner/accounts/:encoded_account_id/contacts/unsubscribe/post.md)

---

[API](https://skmtc.dev/cc/apis/appconnect-v3.md) - [All operations](https://skmtc.dev/cc/apis/appconnect-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/cc/apis/appconnect-v3/revisions/7bcad1d0ff26?raw)