Skip to main content
POST
Create / schedule / publish a social post

Authorizations

X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Headers

X-Idempotency-Key
string

Optional idempotency key. Repeats with the same key + body within 24h return the original response instead of creating a duplicate.

Body

application/json
content
string
required

Shared post body (per-platform overrides via platforms[].custom_content)

platforms
object[]
required
Minimum array length: 1
media_items
object[]
hashtags
string[]
scheduled_for
string<date-time>

Schedule for this time. Omit (with publish_now) for immediate publishing.

scheduled_timezone
string

IANA timezone for the scheduled time

publish_now
boolean

Publish immediately instead of scheduling

recycling
object
article_component_id
string<uuid>

Response

Post accepted for publishing/scheduling

data
object
Last modified on June 30, 2026