Subscribers

Replace subscriber data

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.

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

Path parameters

subscriberIdstring uuid required

UUID of the subscriber.

Headers

If-Matchstring required

Strong ETag from GET /subscribers/{subscriberId}/data.

Request body

emailstring required

Canonicalizable subscriber email address.

firstNamestring required

Subscriber first name. Null clears it.

subscriberStatus'PENDING' | 'CONFIRMED' | 'UNSUBSCRIBED' | 'COLD' | 'BOUNCED' | 'SOFT_BOUNCED' | 'BLOCKED' | 'DELETED' required
tagsstring[] required

Complete customer tag assignment set.

Example request

{
  "fields": [
    {
      "value": {
        "text": "Ann"
      }
    }
  ]
}

Response

Subscriber data replaced.

Changes

No recorded changes to this operation across all 1 revision of this API.