Use the PostEase API

Send it on every request as Authorization: Bearer pe_…, with JSON bodies and Content-Type: application/json. Every address below starts with https://postease.co/api/v1.

401 unauthorized: the token is missing, unknown or revoked. 403 plan_required: the workspace is not on Pro. 404 not_found: the id is not in this workspace, which is also the answer for another workspace’s id. 409 conflict: the post has already started publishing. 422 validation: the body cannot be saved as sent, and the message says why. 500 internal: try again.

GET /channels. Each channel’s id, platform, name, handle, a status of connected or needs_reconnect, and capabilities: whether PostEase can publish to it, read its inbox and read its numbers.

POST /posts. Send text and channel_ids, and optionally captions (text per channel id), media (ids from POST /media), campaign and source. Each channel is checked against its platform’s caption limit as that platform counts it, so a 290-character post for X is refused with “caption is 290 characters; X allows 280”. A channel with its own caption publishes that caption; every other channel publishes text. Editing the post by hand in PostEase replaces the per-channel captions with the one caption you edit. Send an Idempotency-Key header and the same key within 24 hours returns the same post instead of a second one; while the first request with a key is still creating its post, the key is answered 409 idempotency_in_progress, and a retry a few seconds later gets the post. A source of agent or extension is refused, since PostEase marks its own posts with those.

POST /posts/{id}/schedule. Send scheduled_at in ISO 8601, such as 2026-11-02T09:00:00Z. A time now or in the past publishes now. A draft, a scheduled post or a failed post can be scheduled; anything that has started publishing answers 409.

GET /posts/{id}. The post: id, text, captions, channel_ids, media, campaign, source, status, scheduled_at, published_at, error, and per_channel with each channel’s status, platform_post_id, url, error_class and error.

GET /posts?status=&campaign=&limit=. Posts newest first, up to limit (50 unless you say, 100 at most). Status is draft, scheduled, publishing, published, failed or partially_failed.

DELETE /posts/{id}. Cancels a draft, scheduled or failed post and answers with its id and status cancelled. Once any channel has started publishing, it answers 409.

When a channel fails, error_class says why in one word: auth_expired (reconnect the channel), rate_limited, media_rejected, platform_error, validation or unknown. The error field says it in a sentence.

GET /posts/{id}/metrics. Per channel: views, likes, comments, first_day_views (the first 24 hours) and retention_drop_at_s (where a YouTube video loses the most viewers). A number not yet measured is null, never 0. Shares and clicks are not measured per post yet, so they are null.

GET /inbox?unreplied=true&limit=. Messages newest first, each with its channel, platform, author, text, created_at, whether you have replied, and post_id when it is about one of your posts.

POST /inbox/{id}/reply. Send text. The reply goes out on the message’s platform and joins the thread in the Inbox. A platform PostEase cannot reply on answers 422, for example “replies not supported on X”.

POST /media. Send url, an http or https address on the public internet. JPEG, PNG and WebP up to 25 MB, MP4 and MOV up to 500 MB, and a video’s server must state its size. The answer is the file’s id, kind, width, height and duration_s. Addresses on a private network, such as 127.0.0.1 or 169.254.169.254, answer 422.