---
title: "Update contact list subscription status"
method: POST
path: "/api/contactLists.updateStatus"
---

# Update contact list subscription status

`POST /api/contactLists.updateStatus`

Updates the subscription status of a contact in a specific list. Can set status to active, pending, unsubscribed, bounced, or complained.

**Note:** This endpoint only modifies **existing** list memberships. It does not add a contact to a list. To add a contact to a list, use the `/subscribe` endpoint (for public lists) or the `/api/contacts.import` endpoint (for any list, requires authentication).

## Request body

- UpdateContactListStatusRequest
  - `workspace_id` string, required — The ID of the workspace
  - `email` string, email, required — Email address of the contact
  - `list_id` string, required — ID of the list
  - `status` 'active' | 'pending' | 'unsubscribed' | 'bounced' | 'complained', required — New subscription status

## Response `200`

Status updated successfully

- UpdateContactListStatusResponse
  - `success` boolean — Whether the operation was successful
  - `message` string — Status message
  - `found` boolean — Whether the contact was found in the list

## Other responses

- `400` — Bad request - validation failed
- `401` — Unauthorized - invalid or missing authentication token
- `404` — Contact list relationship not found
- `500` — Internal server error

## Changes

- **2025-11-01** `6d2b86adbdc3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pierre-b/apis/notifuse-api/changes/api/contactLists.updateStatus/post.md)

---

[API](https://skmtc.dev/pierre-b/apis/notifuse-api.md) · [All operations](https://skmtc.dev/pierre-b/apis/notifuse-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pierre-b/notifuse-api/revisions/d26605f2fc47/schema)