---
title: "Replace subscriber data"
method: PUT
path: "/subscribers/{subscriberId}/data"
tags: ["Subscribers"]
---

# Replace subscriber data

`PUT /subscribers/{subscriberId}/data`

## Request

- Base URL: `https://api.maildroppa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maildroppa.com/subscribers/{subscriberId}/data`
- Auth: API key in header `X-API-Key`

Atomically replaces email, first name, manual status, the complete custom-field value set, and the complete customer-tag set. If-Match must contain exactly the strong ETag from the corresponding subscriber-data GET. Required active fields cannot be omitted. Assigned archived fields and customer tags may only be retained unchanged or removed by omission. System tags are rejected in the request and preserved server-side.

## Path parameters

- `subscriberId` string, uuid, required

## Headers

- `If-Match` string, required

## Request body

- ReplaceSubscriberData: Atomic full replacement of all publicly replaceable subscriber data.
  - `email` string, required: Canonicalizable subscriber email address.
  - `firstName` string, required: Subscriber first name. Null clears it.
  - `subscriberStatus` 'PENDING' | 'CONFIRMED' | 'UNSUBSCRIBED' | 'COLD' | 'BOUNCED' | 'SOFT_BOUNCED' | 'BLOCKED' | 'DELETED', required
  - `fields` FieldValueInput[], required: Complete custom field value set.
    - `fieldId` string, uuid
    - `value` union: Strict typed subscriber field value accepted by write endpoints.
      - object: Text subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `text` string, required: Text value.
      - object: Email subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `text` string, required: Email value.
      - object: Number subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `number` number, required: Number value.
      - object: Date subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `date` string, date, required
      - object: Boolean subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `booleanValue` boolean, required: Boolean value.
      - object: Single-option subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `optionId` string, uuid, required
      - object: Multi-option subscriber field value.
        - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
        - `optionIds` string[], required: Selected option IDs.
  - `tags` string[], required: Complete customer tag assignment set.

## Response `204`

Subscriber data replaced.

## Other responses

- `400`: Invalid subscriber data or If-Match header.
- `401`: Not Authorized
- `403`: Not Allowed
- `404`: Subscriber not found.
- `409`: Email address is already assigned.
- `412`: Subscriber data changed since it was read.
- `428`: If-Match is required, or the customer agreements must be accepted before using API keys.

---

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