---
title: "Update a subscriber"
method: PATCH
path: "/v1/subscribers/{subscriber_id}"
tags: ["Subscribers"]
---

# Update a subscriber

`PATCH /v1/subscribers/{subscriber_id}`

## Request

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

Updates profile fields, status, custom fields, tags, or sequence assignments for one subscriber. Fields omitted from the request stay unchanged. Blank optional custom field values also leave saved values unchanged, and filled-in invalid values are rejected.

## Path parameters

- `subscriber_id` string, required

## Request body

- SubscriberUpdateRequest
  - `email` string, email
  - `name` string
  - `country` string, nullable: Two-letter country code or country name. Mailrith stores Subscriber country as a two-letter country code.
  - `subscribed_on` string: Subscriber-local subscription date in YYYY-MM-DD format.
  - `custom_fields` object: Custom field values keyed by custom field ID. For Multi Select fields, send an array of option names or a comma-separated string. Blank optional values leave saved values unchanged, and filled-in invalid values are rejected.

## 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
- `401`: Authentication is required or invalid
- `404`: Resource not found
- `409`: Request conflicts with an existing resource or current state

---

[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)