Getting startedIntroduction

Introduction

Understand uploads, posts, account queues, and the human posting workflow.

Upload videos and carousels, distribute them across social accounts, and track the human posting workflow from your own tools or AI agents.

Building with an AI agent? These docs are one markdown file at /llms.txt

First, get an API key

Create one in the dashboard under Settings → API & MCP. Pick only the scopes you need — the secret is shown once, so store it safely.

Get your API key

Core concepts#

The API prepares and queues content; trained operators complete the final platform posting step.

01

Uploads

Import public URLs or send media to a temporary upload URL.

02

Posts

Combine ready media, a caption, and the accounts you want to reach.

03

Account queues

Each account receives its own ordered queue item.

04

Human posting

An operator reviews and posts natively to each platform.

Status lifecycle#

Follow each post from review through the per-account publishing queue.

Primary lifecycle#

1draft
The post exists but has not been queued to any accounts.
2pending_approval
The post is waiting for a HumanPost reviewer.
3queued
Approved and waiting in each target account's queue.
4posting
A human operator is actively publishing the post.
5posted
Published successfully to the social platform.

Other states#

partially_postedPublished to some accounts while other account targets remain active.
processingUploaded media is still being prepared.
cancelledThe queued item was cancelled before posting.
failedPublishing or media processing could not complete.