---
title: "Replace a subscriber field value."
method: PUT
path: "/subscribers/{subscriberId}/field-values/{fieldId}"
tags: ["Subscriber Field Values"]
---

# Replace a subscriber field value.

`PUT /subscribers/{subscriberId}/field-values/{fieldId}`

## 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}/field-values/{fieldId}`
- Auth: API key in header `X-API-Key`

Replaces one active typed subscriber field value. Blank TEXT and EMAIL values clear an optional field; required and archived fields cannot be cleared or changed.

## Path parameters

- `fieldId` string, uuid, required
- `subscriberId` string, uuid, required

## Request body

- UpdateFieldValue: Replacement value for a single subscriber field.
  - `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.

## Response `204`

Field value replaced or cleared.

## Other responses

- `400`: Invalid value kind or field/value mismatch.
- `401`: Not Authorized
- `403`: Not Allowed
- `404`: Subscriber or field not found.
- `428`: Accept the customer agreements in the app 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)