Marketing

The hanzo marketing commands.

Also for this capability: API · CLI · MCP · SDKs

Lifecycle email: drip sequences that reach the right people.

hanzo marketing promos list

Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.

Command	What it does
`hanzo marketing summary`	Rolls up the caller org's campaigns: how many there are, how many are active, and the summed budget and spend in cents.
`hanzo marketing unsubscribe`	The PUBLIC one-click endpoint (no principal): a recipient clicks the signed link in an email footer.

Audiences

Command	What it does
`hanzo marketing audiences create`	Saves a cohort filter for the caller's org.
`hanzo marketing audiences get <id>`	Returns one of the caller org's saved audiences.
`hanzo marketing audiences list`	Returns the org's saved audiences, most recently updated first.
`hanzo marketing audiences preview <id>`	Evaluates the cohort LIVE — the same resolution an enrollment would run — and reports how big it is and how many real mailboxes it reaches.
`hanzo marketing audiences rm <id>`	Removes one of the caller org's audiences and answers 204.

Calendar

Command	What it does
`hanzo marketing calendar create`	Adds a post to the content calendar.
`hanzo marketing calendar get <id>`	Returns one of the caller org's posts, including the exact error behind a failed publish.
`hanzo marketing calendar list`	Returns the org's calendar, latest scheduled first, optionally narrowed to one status.
`hanzo marketing calendar rm <id>`	Removes one of the caller org's posts and answers 204.
`hanzo marketing calendar set <id>`	Replaces a post's editable fields.

Campaigns

Command	What it does
`hanzo marketing campaigns create`	Registers a campaign in the caller's org.
`hanzo marketing campaigns get <id>`	Returns one of the caller org's campaigns.
`hanzo marketing campaigns list`	Returns the org's campaigns, most recently updated first, optionally narrowed to one lifecycle status.
`hanzo marketing campaigns rm <id>`	Removes one of the caller org's campaigns and answers 204.
`hanzo marketing campaigns schedule <id>`	Sets a campaign's send time and moves it to "scheduled".
`hanzo marketing campaigns set <id>`	Replaces a campaign's editable fields.

Promos

Command	What it does
`hanzo marketing promos eligibility <code>`	Prices a promo against a plan and seat count.
`hanzo marketing promos list`	Returns every promo the deployment offers with its live counters: how many orgs have redeemed it and how many redemptions remain under the cap.
`hanzo marketing promos redeem <code>`	Records the caller org's claim on a promo.
`hanzo marketing promos redemption <code>`	Returns the caller org's OWN redemption of a promo — an org-scoped read, so it can never surface another tenant's.

Sequences

Command	What it does
`hanzo marketing sequences create`	Registers a drip sequence in the caller's org.
`hanzo marketing sequences enroll <id>`	Adds one contact or a whole audience to a sequence and schedules the first step for each.
`hanzo marketing sequences enrollments cancel <id> <eid>`	Stops one walk mid-sequence and answers 204: no further step is sent, and steps already delivered are not recalled.
`hanzo marketing sequences enrollments list <id>`	Returns who is walking one sequence, most recently enrolled first, with each walk's current step and next due time.
`hanzo marketing sequences get <id>`	Returns one of the caller org's sequences together with its steps in send order.
`hanzo marketing sequences list`	Returns the org's drip sequences, most recently updated first.
`hanzo marketing sequences status <id>`	Flips draft/active/archived — the activation gate for sending, since only an active sequence accepts enrollments.
`hanzo marketing sequences steps create <id>`	Appends a message to the END of a sequence: the new step's idx is one past the last, so steps arrive in the order they are added.
`hanzo marketing sequences steps get <id>`	Returns one sequence's steps in send order.

Suppressions

Command	What it does
`hanzo marketing suppressions clear`	Re-subscribes an address on one channel and answers 204.
`hanzo marketing suppressions create`	Records an opt-out for the org (admin / self-service management).
`hanzo marketing suppressions get`	Returns the org's opt-out list, newest first — everyone the send gate will refuse to deliver to.

Was this page useful?

Previousx402 NextCampaign