Create Issue

POST

/newsletters/{newsletter_id}/issues

• Production
• QA

Create a draft newsletter issue.

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

html_body

required

string

plain_text

Any of:

string

string

null

null

preview_text

Any of:

string

string

<= 500 characters

null

null

reply_to

Any of:

string

string format: email

null

null

sender_email

Any of:

string

string format: email

null

null

sender_name

Any of:

string

string

<= 255 characters

null

null

subject

required

string

<= 2000 characters

Responses

201

Successful Response

object

data

required

A single newsletter issue. Open dict — the internal handler returns the row dict plus derived KPI/status fields.

object

created_at

Any of:

string

string

null

null

id

Any of:

integer

integer

null

null

newsletter_id

Any of:

string

string

null

null

sent_at

Any of:

string

string

null

null

status

Any of:

string

string

null

null

subject

Any of:

string

string

null

null

updated_at

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

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string