---
title: "Change Subscriber sending eligibility"
method: PUT
path: "/v1/subscribers/{subscriber_id}/status"
tags: ["Subscribers"]
---

# Change Subscriber sending eligibility

`PUT /v1/subscribers/{subscriber_id}/status`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/subscribers/{subscriber_id}/status`
- Auth: HTTP bearer

Changes the delivery status for one Subscriber without changing profile, targeting, or Sequence enrollment fields. Making a Subscriber Active requires consent_evidence; its collected_at value must include the correct UTC offset and must not be later than Mailrith's server time.

## Path parameters

- `subscriber_id` string, required

## Request body

- SubscriberStatusRequest
  - `status` 'Active' | 'Unconfirmed' | 'Unsubscribed' | 'Complained' | 'Bounced' | 'Blocked', required
  - `consent_evidence` ConsentEvidence: Compact evidence required when the public API makes a Subscriber Active. Keep raw consent text, IP addresses, and user-agent data in your evidence system; Mailrith stores only this version, reference, URL, and optional SHA-256 digest.
    - `lawful_basis` string, required
    - `consent_text_version` string, nullable
    - `collected_at` string, required: When the consent evidence was collected, as ISO 8601 with an explicit UTC offset. This must not be later than Mailrith's server time. Do not treat a workspace-local clock as UTC; use the evidence record's confirmed timestamp.
    - `source_url` string, uri, nullable
    - `evidence_reference` string, required
    - `technical_evidence_hash` string, nullable

## Response `200`

Successful response

- object
  - `data` Subscriber, required
    - `self` string, required: Stable relative Public API path for retrieving this resource.
    - `id` string, required
    - `email` string, email, required
    - `name` string, required
    - `status` 'Active' | 'Unconfirmed' | 'Unsubscribed' | 'Complained' | 'Bounced' | 'Blocked', required
    - `country` string, nullable, required: Two-letter country code or country name. Mailrith stores Subscriber country as a two-letter country code.
    - `subscribed_at` string, date-time, required
    - `last_opened_at` string, date-time, nullable
    - `tags` TagSummary[], required
      - `id` string, required
      - `name` string, required
    - `sequence_ids` string[], required
    - `custom_fields` object, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: Request is invalid
- `404`: Subscriber not found

---

[API](https://skmtc.dev/mailrith/apis/mailrith-api.md) · [All operations](https://skmtc.dev/mailrith/apis/mailrith-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailrith/apis/mailrith-api/revisions/41f09536f2da?raw)