# Marketing URL: https://docs.hanzo.ai/docs/cli/marketing > The `hanzo marketing` commands. Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/marketing) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/marketing) · [SDKs](https://docs.hanzo.ai/docs/sdks) Lifecycle email: drip sequences that reach the right people. [API reference →](https://docs.hanzo.ai/docs/openapi/marketing) ```bash 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 ` | 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 ` | 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 ` | 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 ` | 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 ` | Removes one of the caller org's posts and answers 204. | | `hanzo marketing calendar set ` | 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 ` | 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 ` | Removes one of the caller org's campaigns and answers 204. | | `hanzo marketing campaigns schedule ` | Sets a campaign's send time and moves it to "scheduled". | | `hanzo marketing campaigns set ` | Replaces a campaign's editable fields. | ### Promos | Command | What it does | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `hanzo marketing promos eligibility ` | 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 ` | Records the caller org's claim on a promo. | | `hanzo marketing promos redemption ` | 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 ` | Adds one contact or a whole audience to a sequence and schedules the first step for each. | | `hanzo marketing sequences enrollments cancel ` | 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 ` | Returns who is walking one sequence, most recently enrolled first, with each walk's current step and next due time. | | `hanzo marketing sequences get ` | 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 ` | Flips draft/active/archived — the activation gate for sending, since only an active sequence accepts enrollments. | | `hanzo marketing sequences steps create ` | 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 ` | 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. |