Skip to main content
POST

Authorizations

Authorization
string
header
required

Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API.

Headers

Content-Type
string
required

Request body type

Body

application/json

Where the reader opted in again, e.g. account settings page. 1–100 letters, numbers, spaces and . , : - _ / @ +

Maximum string length: 100

When the reader opted in again (RFC 3339, e.g. 2026-11-09T11:04:24+05:30). Not in the future, within the last 90 days, and after the contact unsubscribed.

email
string

Email of the contact. Send email or contact_id, not both.

Maximum string length: 200
contact_id
string

Id of the contact. Send email or contact_id, not both.

list_id
string

Optional. A list of your account to add the contact to. A contact with no list is placed in it; otherwise it is added as an extra list only if your account allows a contact in more than one list (else 422). With double opt-in the list is added when the reader confirms.

Optional. The reader's IP address when they opted in (IPv4 or IPv6), as recorded by you.

Optional. The wording the reader agreed to. Up to 500 letters, numbers, spaces and . , : - _ / @ +

Maximum string length: 500

Response

Re-subscribed, or already subscribed

contact_id
string
status
string
resubscribed_at
string<date-time>
changed
boolean

false when the contact was already subscribed