---
title: "Update Email Status"
method: PATCH
path: "/api/subscriber/{subscriberId}/email-status"
tags: ["Subscriber"]
---

# Update Email Status

`PATCH /api/subscriber/{subscriberId}/email-status`

Update subscriber email status that affects how emails would be sent to all lists. Subscribers who marks email as spam or unsubscribes globally from all list. This is the second tier in the Subscriber Suppresion hit tier.<br><br>*Rate limit*:<br>Limit: 150<br>TTL: 60s

**Scopes:**
`subscriber:manage`

## Path parameters

- `subscriberId` string, required — Primary key that uniquely identifies this subscriber. Generated by Bespoke.

## Headers

- `revision` string, required

## Request body

- UpdateSubscriberEmailStatusDto
  - `data` UpdateSubscriberemailStatusDataObject, required
    - `type` 'list' | 'subscriber', required
    - `subscriberId` string, required — Primary key that uniquely identifies this subscriber. Generated by Bespoke.
    - `attributes` UpdateSubscriberEmailStatusAttributesObject, required
      - `emailStatus` 'SUBSCRIBED' | 'UNSUBSCRIBED' | 'MARKED_AS_SPAM', required — Subscriber email status

## Response `200`

Update Email Status

- Subscriber
  - `id` string, required
  - `firstName` object, required
  - `lastName` object, required
  - `phoneNumber` object, required
  - `emailStatus` string, required
  - `updatedEmailStatusAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `subscriberAddress` object, required

## Other responses

- `5XX`
- `4XX`

---

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