---
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`

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.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/revisions/4b4a534c818d/schema)