Marketing The `hanzo marketing` commands.
Also for this capability: API · CLI · MCP · SDKs
Lifecycle email: drip sequences that reach the right people.
API reference →
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 summaryRolls up the caller org's campaigns: how many there are, how many are active, and the summed budget and spend in cents. hanzo marketing unsubscribeIs the PUBLIC one-click endpoint (no principal): a recipient clicks the signed link in an email footer.
Command What it does hanzo marketing audiences createSaves 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 listReturns 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… hanzo marketing audiences rm <id>Removes one of the caller org's audiences and answers 204.
Command What it does hanzo marketing calendar createAdds 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 listReturns the org's calendar, latest scheduled first, optionally narrowed to one status. hanzo marketing calendar publish <id>Publishes a post NOW, synchronously, whatever its schedule. 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.
Command What it does hanzo marketing campaigns createRegisters a campaign in the caller's org. hanzo marketing campaigns get <id>Returns one of the caller org's campaigns. hanzo marketing campaigns listReturns 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.
Command What it does hanzo marketing promos eligibility <code>Prices a promo against a plan and seat count. hanzo marketing promos listReturns every promo the deployment offers with its live counters: how many orgs have redeemed it and how many… 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.
Command What it does hanzo marketing sequences createRegisters 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 listReturns 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… hanzo marketing sequences steps get <id>Returns one sequence's steps in send order.
Command What it does hanzo marketing suppressions clearRe-subscribes an address on one channel and answers 204. hanzo marketing suppressions createRecords an opt-out for the org (admin / self-service management). hanzo marketing suppressions getReturns the org's opt-out list, newest first — everyone the send gate will refuse to deliver to.
How is this guide?