API Reference
The OmniPost API is a REST API with JSON request and response bodies. All endpoints below are relative to the base URL and require the Authorization header described in Authentication.
Base URL
https://api.omnipost.dev/v1Self-hosted deployments mount the same routes under {APP_URL}/api/v1.
Required headers
| Header | Required | Description |
|---|---|---|
| Authorization | Always | Bearer op_live_... or Bearer op_sandbox_.... |
| Content-Type | On requests with a body | application/json. |
| Idempotency-Key | Optional | Safe-retry key for POST /v1/upload. See Errors. |
Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/upload | Create a post targeting one or more platforms. |
| GET | /v1/posts | List posts, paginated and filterable. |
| GET | /v1/posts/:id | Fetch a single post and its per-platform targets. |
| GET | /v1/accounts | List connected social accounts. |
| POST | /v1/accounts/:platform/connect | Get a hosted OAuth connect URL. |
| DELETE | /v1/accounts/:id | Disconnect a social account. |
| POST | /v1/webhooks | Register a webhook endpoint. |
Conventions
Timestamps are ISO 8601 UTC (2026-08-02T14:03:11Z). IDs are opaque strings prefixed by resource type (post_, acct_, wh_) — treat them as opaque and don't parse their structure. Platform identifiers in request and response bodies are always the lowercase strings instagram, threads, tiktok, and x.