Skip to main content
CampaignsVersion: v3New

Validate Email Campaign Before Sending

POST/emails/locations/{locationId}/campaigns/emails/{campaignId}/validate

Inspect rendered HTML and intended sender metadata for missing subject, sender, unsubscribe link, broken placeholders, merge field syntax the send cannot parse (INVALID_MERGE_FIELD_SYNTAX) and unresolved fields. Optional overrides are checked without saving. ready means no content errors. Warns with SENDER_DOMAIN_NOT_VERIFIED when the sender is not on a location sending domain (see List Sending Domains); it does not verify delivery.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:emails/campaigns.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

locationIdstringrequired

Location ID

Example:ve9EPM428h8vShlRW1KT
campaignIdstringrequired

Campaign ID

Example:67f15c2ae99226d5bcccb8f3

Body

subjectstring

Subject to use for this request. Omit to use the stored subject; an empty string fails send validation.

Example:Holiday sale starts now
fromNamestring

Sender display name for this request. Defaults to the stored sender name; empty string omits the display name.

Example:Anz Studio
fromEmailstring

Sender email address for this request. Must be a valid email address. Defaults to the stored fromAddress.

Response

Success

readybooleanrequired

True only when there are no errors. This is a content check, not a delivery or sender-domain verification guarantee.

Example:false
errorsobject[]required

Blocking issues that must be corrected before sending.

warningsobject[]required

Non-blocking issues worth reviewing before sending.

summaryobjectrequired

Effective metadata and counts for the inspected rendered HTML.

unresolvedMergeFieldsstring[]required

All distinct {{...}} tokens found, including standard send-time tokens which do not produce warnings.

Example:["{{contact.first_name}}"]