API overview - TryPost Connect

https://connect.trypost.it/api

Every authenticated route needs:

Authorization: Bearer YOUR_API_KEY

Create keys in the dashboard or POST /api-keys. The two credentials are not interchangeable — Authentication. Try the same routes in the playground.

Rate limits

Authenticated routes are 60 requests / minute per account (429 + Retry-After). Local development is unlimited. GET /social-accounts/{id}/boards and /channels are 60 / minute on their own. The signed media PUT is 60 / minute per account and 1200 / minute per IP.

Errors

All error bodies include a message field. Validation errors also include errors.

Status	Meaning
`200`	Success
`201`	Created
`204`	Deleted
`401`	Missing or invalid API key
`402`	Card / active subscription required
`403`	Forbidden (role, or an API key sent to `/mcp`)
`404`	Missing, or not on this account
`422`	Validation
`429`	Rate limit — wait `Retry-After` seconds

A 402 on connect or any other call means the account needs a card (X, or a third non-X identity) or lost app access. Fix it under Settings → Billing, then retry.

Quick reference

Resource	Endpoints
Posts	`GET /posts`, `POST /posts`, `GET /posts/{id}`, `PUT /posts/{id}`, `DELETE /posts/{id}`, `GET /posts/{id}/metrics`, `GET /posts/{id}/preview`
Media	`POST /medias/presign`, `PUT /medias/{token}` (signed, no Bearer)
Social accounts	`GET /social-accounts/connect/{platform}`, `GET /social-accounts`, `DELETE /social-accounts/{id}`, `PUT /social-accounts/{id}/set`, `GET /social-accounts/{id}/boards`, `GET /social-accounts/{id}/channels`
Social sets	`GET /social-sets`, `POST /social-sets`, `GET /social-sets/{id}`, `PUT /social-sets/{id}`, `DELETE /social-sets/{id}`
Account	`GET /account`
API keys	`GET /api-keys`, `POST /api-keys`, `DELETE /api-keys/{id}`
Logs	`GET /logs`, `GET /logs/{id}`
Webhooks	`GET /webhooks`, `POST /webhooks`, `GET /webhooks/{id}`, `PUT /webhooks/{id}`, `DELETE /webhooks/{id}`, `POST /webhooks/{id}/send-test`, `POST /webhooks/{id}/rotate-secret`, `GET /webhooks/{id}/logs`, `POST /webhooks/{id}/logs/{log_id}/replay`

There are no /assets, /content-types, /signatures, /labels, /repurposes, or /workspace routes.

Pagination

These lists paginate (data, links, meta). Use page. Size is meta.per_page (default 25). There is no per_page query.

Everything else that lists resources returns a plain array. Resources are unwrapped — no data: envelope on a single object.

​Rate limits

​Errors

​Quick reference

​Pagination

Rate limits

Errors

Quick reference

Pagination