Hanzo
OpenapiMarketing

Returns the org's calendar, latest scheduled first, optionally narrowed to one…

Returns the org's calendar, latest scheduled first, optionally narrowed to one status.

GET /v1/marketing/calendar

Addresshttps://api.hanzo.ai/v1/marketing/calendar
MethodGET
Operationget_marketing_calendar
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the org's calendar, latest scheduled first, optionally narrowed to one status.

Request

2 fields.

FieldInTypeRequiredDescription
statusquerystringStatus keeps only posts in that state (draft, scheduled, published, failed, canceled).
limitqueryintegerLimit caps the rows returned; 0 means 200 and nothing above 1000 is honoured.

Response

StatusBodyMeaning
200PostListok

200 body — 11 fields.

FieldInTypeAlwaysDescription
databodyCalendarPost[]Data is the page, ordered by scheduledAt descending — the furthest-out post first and unscheduled drafts (scheduledAt 0) last.
data[].bodybodystringBody is the post text.
data[].channelbodystringChannel is the target network: x, facebook, instagram, linkedin, tiktok, youtube or threads.
data[].createdAtbodyintegerCreatedAt is unix seconds when the post was added, server-assigned and never rewritten.
data[].errorbodystringError is the exact reason the last publish attempt failed — the honest record behind a "failed" status, never a faked success.
data[].idbodystringID is the server-assigned post id ("cal_" + 128 random bits).
data[].publishedAtbodyintegerPublishedAt is when the publish succeeded; 0 until it does.
data[].scheduledAtbodyintegerScheduledAt is the unix publish time; 0 leaves the post a draft, and any value makes it "scheduled" for the durable sweep to pick up.
data[].statusbodystringStatus is draft, scheduled, published, failed or canceled.
data[].titlebodystringTitle is the post's internal label, capped at 1024 bytes.
data[].updatedAtbodyintegerUpdatedAt is unix seconds of the last write, server-assigned.

Failure carries the platform error shape — see Errors.

Examples

hanzo marketing calendar list

Marketing API · All Hanzo APIs · Interactive reference

How is this guide?

On this page