Skip to main content
PATCH
Error

Authorizations

X-API-Key
string
header
required

API key authentication

Path Parameters

campaignId
string
required

Response

Successfully updated

_id
string

Id of the campaign

cancelledAt
string | null

Timestamp when the campaign was cancelled or failed

createdAt
string

Date and time of creation

editorType
enum<string>

Which editor produced the campaign body. Campaigns created before the editor choice existed read back as 'unlayer'.

Available options:
unlayer,
code
failedCount
number

Failed sent count

from
string

From email address

hostedUrl
string | null

Public URL of the campaign's hosted copy. Always present; null unless the campaign sent successfully and its hosted artifact was stored.

name
string

Name of the campaign

plainTextBody
string

Plaintext version of the email body without HTML formatting

Example:

"Hello, world! This is a plaintext version of the email without any HTML formatting."

previewImageUrl
string

URL of the last thumbnail that finished rendering. The thumbnail is rendered after the response is sent, so this value may lag a content-changing write and is absent on a freshly created campaign.

previewText
string

Preview text of the email

scheduledAt
string

Date and time of scheduled email

sentCount
number

Successfully sent count

status
string

Status of the campaign

subStatus
enum<string> | null

Granular failure/cancellation reason. Null for non-failure states or legacy campaigns.

Available options:
missing_billing_info,
account_suspended,
invalid_subscription,
system_error,
quota_exceeded,
circuit_breaker_bounce,
circuit_breaker_complaint,
circuit_breaker_combined,
rejected_automated_review,
rejected_manual_review,
null
subject
string

Subject of the email

totalRecipients
number

Contacts this campaign is expected to email. 0 until the campaign is scheduled (except for an explicit contact-list audience, counted at creation), then estimated from the audience; narrows to the mailable (active) population when the send begins — the figure the sending-allowance decision uses.

updatedAt
string

Date and time of last update