Hanzo
OpenapiMarketing

Returns the org's campaigns, most recently updated first, optionally narrowed…

Returns the org's campaigns, most recently updated first, optionally narrowed to one lifecycle status.

GET /v1/marketing/campaigns

Addresshttps://api.hanzo.ai/v1/marketing/campaigns
MethodGET
Operationget_marketing_campaigns
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the org's campaigns, most recently updated first, optionally narrowed to one lifecycle status.

Request

2 fields.

FieldInTypeRequiredDescription
statusquerystringStatus keeps only campaigns in that lifecycle state (draft, scheduled, active, paused, completed).
limitqueryintegerLimit caps the rows returned; 0 means 200 and nothing above 1000 is honoured.

Response

StatusBodyMeaning
200CampaignListok

200 body — 11 fields.

FieldInTypeAlwaysDescription
databodyCampaign[]Data is the page; an empty array when the org has no matching campaign.
data[].budgetbodyintegerBudget is what the campaign is allowed to cost, in USD cents.
data[].channelbodystringChannel is the delivery surface: email, sms, social, meta, google or tiktok.
data[].createdAtbodyintegerCreatedAt is unix seconds when the campaign was registered.
data[].idbodystringID is the server-assigned campaign id ("camp_" + 128 random bits).
data[].namebodystringName is the campaign's label.
data[].objectivebodystringObjective is the free-text goal ("signups"), capped at 1024 bytes.
data[].scheduledAtbodyintegerScheduledAt is the unix send time; 0 means unscheduled.
data[].spendbodyintegerSpend is what the campaign has cost so far, in USD cents, clamped to >= 0.
data[].statusbodystringStatus is the lifecycle: draft, scheduled, active, paused or completed.
data[].updatedAtbodyintegerUpdatedAt is unix seconds of the last write.

Failure carries the platform error shape — see Errors.

Examples

hanzo marketing campaigns list

Marketing API · All Hanzo APIs · Interactive reference

How is this guide?

On this page