Meridian handbook
ReferenceCLI

newsletter

engine-dmo newsletter: The newsletter's subscribers, campaigns and deliverability. Every subcommand, argument and flag.

The newsletter’s subscribers, campaigns and deliverability.

CommandWhat it does
engine-dmo newsletter campaignsList a site’s campaigns
engine-dmo newsletter deliverabilityCheck SPF, DKIM and DMARC for each site’s sending domain, record the results, and show the complaint rate
engine-dmo newsletter exportExport a site’s subscribers, or with --topics the recipients of that segment, as CSV; audited with the row count
engine-dmo newsletter hygieneReport a site’s list health: active, dormant, never confirmed, unsubscribed and bounced
engine-dmo newsletter importImport subscribers from a CSV file under a declared lawful basis, recorded on every row; --dry-run counts and writes nothing
engine-dmo newsletter sendSend a draft campaign now; needs --confirm, since a send cannot be taken back
engine-dmo newsletter subscribersList a site’s subscribers; --dormant 12m lists the active ones with no click in that period
engine-dmo newsletter suppressSuppress an address on every channel: an alias for engine-dmo mail suppression add

engine-dmo newsletter campaigns

List a site’s campaigns.

engine-dmo newsletter campaigns [flags]
FlagTypeDefaultMeaning
--sitestringsite key
--statusstringdraft | scheduled | sending | sent | cancelled

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo newsletter deliverability

Check SPF, DKIM and DMARC for each site’s sending domain, record the results, and show the complaint rate.

engine-dmo newsletter deliverability

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo newsletter export

Export a site’s subscribers, or with --topics the recipients of that segment, as CSV; audited with the row count.

engine-dmo newsletter export [flags]
FlagTypeDefaultMeaning
--outstringfile to write; standard output when empty
--sitestringsite key
--statusstringonly subscribers in this status
--topicsstringa segment: the recipients interested in any of these topics, comma separated

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo newsletter hygiene

Report a site’s list health: active, dormant, never confirmed, unsubscribed and bounced.

engine-dmo newsletter hygiene [flags]
FlagTypeDefaultMeaning
--reportboolprint the report
--sitestringsite key

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo newsletter import

Import subscribers from a CSV file under a declared lawful basis, recorded on every row; --dry-run counts and writes nothing.

engine-dmo newsletter import [flags]
FlagTypeDefaultMeaning
--basisstringthe lawful basis: consent | legitimate_interest | contract
--dry-runboolcount what would happen and write nothing
--filestringCSV file with an email column, and optionally name, locale, topics and consented_at
--sitestringsite key

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo newsletter send

Send a draft campaign now; needs --confirm, since a send cannot be taken back.

engine-dmo newsletter send [flags]
FlagTypeDefaultMeaning
--campaignstringcampaign id
--confirmboolsend it

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo newsletter subscribers

List a site’s subscribers; --dormant 12m lists the active ones with no click in that period.

engine-dmo newsletter subscribers [flags]
FlagTypeDefaultMeaning
--dormantstringa period such as 12m: active subscribers with no click since
--sitestringsite key
--statusstringpending | active | unsubscribed | bounced | complained | suppressed

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo newsletter suppress

Suppress an address on every channel: an alias for engine-dmo mail suppression add.

engine-dmo newsletter suppress [flags]
FlagTypeDefaultMeaning
--emailstringaddress
--reasonstringmanualhard_bounce | complaint | manual | unsubscribe_all | erasure

--json prints the text output in the JSON envelope. Runs in a project.