API reference
All 43 endpoints of the Postacio REST API, with their fields, limits and examples. Drawn from the same OpenAPI document your tools can load, so it is never out of date.
New here? Start with the developer guide: your first key, your first draft, and connecting an AI agent.
Base URL
Every path is relative tohttps://postacio.com/api/v1. Requests and answers are JSON.Authentication
SendAuthorization: Bearer pk_live_…on every request. An API key (pk_live_…) or an agent access token (at_…). Get a keyRetrying safely
Up to 128 visible ASCII characters. Retrying with the same key and body within 24 hours replays the first answer (withIdempotent-Replayed: true) instead of doing the work twice; the same key with a different body is 422idempotency_conflict.Rate limits
Every answer carriesX-RateLimit-Limit,X-RateLimit-RemainingandX-RateLimit-Resetfor the key, and the same with-User-for the account. A 429 addsRetry-After. The limitsErrors
A failed request answers in the Error envelope, witherror.code,error.message,error.param,error.detail,error.retry_afteranderror.needed. What they mean
Endpoints.
Grouped by what they work on. Every example runs as it is once your key is set.
- AccountWho a request acts as, and this document.
- GroupsA group is one brand's connected accounts. A key sees only the groups it was given.
- DraftsOne post or thread for one or more accounts. Plan it, schedule it, publish it and send it for approval here.
- CommentsThe review comments on a draft, the same ones its comment panel shows.
- MediaUpload a file or import one from a link, then put it in a draft's media.
- TagsThe labels posts are filed under.
- QueueA group's recurring posting slots: the times next-free-slot fills.
- GoalsHow often each account should post, the caps it should stay under, and how far it is this week or month.
- AnalyticsHow published posts did, per account and for a group.
- WebhooksSubscriptions that POST draft events to your URL, and what each delivery carries.
- ObjectsWhat the endpoints answer with, each described once. Lists and pages hold these in their
items.
Ready to send your first draft?
Start your free trial, create a key in Settings, and call the API in a minute.