Add Subscriber

POST

/newsletters/{newsletter_id}/subscribers

• Production
• QA

Add a single subscriber (staff action, status=subscribed). Also creates/links a first-class CRM contact so the subscriber joins the central suppression model (mirrors the manual public subscribe form).

Authorizations

• BearerAuth

Parameters

Path Parameters

newsletter_id

required

Newsletter UUID

string format: uuid

Newsletter UUID

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

object

email

required

string

<= 255 characters

first_name

Any of:

string

string

<= 255 characters

null

null

last_name

Any of:

string

string

<= 255 characters

null

null

Responses

201

Successful Response

object

data

required

A single newsletter subscriber row.

object

created_at

Any of:

string

string

null

null

email

Any of:

string

string

null

null

first_name

Any of:

string

string

null

null

id

Any of:

integer

integer

null

null

last_name

Any of:

string

string

null

null

status

Any of:

string

string

null

null

verification_status

Any of:

string

string

null

null

key

additional properties

any

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string