---
title: "Change Contact Status"
method: POST
path: "/v1/contacts/status"
tags: ["Contacts"]
---

# Change Contact Status

`POST /v1/contacts/status`

Change a contact's subscription status by email. Requires API key with audience:write.

## Request body

- ChangeStatusRequest
  - `email` string, email, required — Email address of the contact
  - `status` 'subscribed' | 'unsubscribed' | 'bounced' | 'non-subscribed', required — New status for the contact
  - `allLists` boolean — Apply to all lists
  - `tags` string[] — Specific tag IDs to scope the status change
  - `projectId` string, required — Project ID

## Response `200`

Status updated

- ApiResponseSuccess
  - `success` boolean, required
  - `data` object, nullable
    - `success` boolean
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.net/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/migma/migma-ai-api-v1/revisions/3f3dba69574b/schema)