---
title: "Update subscriber"
method: PUT
path: "/lists/{list_id}/update-subscriber"
tags: ["Lists"]
---

# Update subscriber

`PUT /lists/{list_id}/update-subscriber`

Update an existing subscriber in a specific list.

## Path parameters

- `list_id` integer, required

## Request body

- object
  - `email` string, required — Email address of the subscriber to update.
  - `subscriber_data` object — Updated subscriber information.
    - `name` string — First name.
    - `surname` string — Last name.
    - `gender` string — Gender. Must be `male` or `female`.
    - `company` string — Company name.
    - `city` string — City.
    - `street` string — Street address.
    - `zip` string — ZIP or postal code.
    - `country` string — Country code.
    - `phone` string — Phone number.
    - `pretitle` string — Pre-title (e.g. Mr., Mrs.).
    - `surtitle` string — Post-nominal title (e.g. PhD).
    - `birthday` string — Birthday in `YYYY-MM-DD` format.
    - `nameday` string — Name day in `MM-DD` format.
    - `source` string — Source of the subscriber.
    - `custom_fields` object — Custom field values. Limited to 5000 characters total. Keys are case-insensitive — they are trimmed and lowercased on input, so `SHOP`, `shop` and ` Shop ` are treated as the same field. Two keys that differ only in case or whitespace in the same request are rejected as duplicates.
    - `tags` unknown[] — Subscriber tags. Limited to 2000 characters total and 50 characters per tag. Content overwrites current tags.
      - unknown
    - `groups` object — Group assignments. Overwrites current values.

## Response `200`

OK

- object
  - `id` integer
  - `name` string
  - `surname` string
  - `email` string
  - `gender` string
  - `bounce_soft` integer
  - `bounce_hard` unknown
  - `bounce_message` unknown
  - `inserted_at` string

## Other responses

- `422` — Unprocessable Entity

---

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