REST API overview
Bearer auth, JSON in / JSON out, Zod-validated input. The /v1 surface that powers everything in the dashboard.
The Post Mate REST API gives you programmatic access to everything the dashboard does — scheduling posts, listing connections, reading analytics, managing the queue.
The base URL is https://post-mate.com/v1. All requests need a
Authorization: Bearer <key> header. Responses are JSON.
Quick example
curl -X POST https://post-mate.com/v1/posts \
-H "Authorization: Bearer pm_live_…" \
-H "Content-Type: application/json" \
-d '{
"caption": "Hello from the API",
"platforms": ["instagram", "linkedin"],
"scheduled_at": "2026-06-01T09:00:00Z"
}'A successful response:
{
"id": "post_01HSXF…",
"status": "scheduled",
"scheduled_at": "2026-06-01T09:00:00Z",
"platforms": ["instagram", "linkedin"]
}What you can do via the API
| Endpoint | Method | Purpose |
|---|---|---|
/v1/posts | POST | Create a scheduled post |
/v1/posts | GET | List posts (filter by status, network, date) |
/v1/posts/:id | GET / PATCH / DELETE | Read, edit, cancel |
/v1/accounts | GET | List connected social accounts |
/v1/analytics | GET | Read post-level analytics |
/v1/media | POST | Upload media for an API-created post |
Full Zod-validated input schemas + response shapes live in the OpenAPI spec.
Rate limits
- 60 requests per minute per API key (sliding window)
- 429 with
Retry-Afterheader when you hit the limit - No daily cap — burst-friendly
The API add-on
The API and webhooks are gated behind a $5/month add-on subscription. This sits on top of either Creator or Pro — see Plans.
The reason: about 5% of our users actually use the API. Charging everyone for infrastructure 95% don't touch felt wrong, so we broke it out into an opt-in add-on. Same logic for the MCP server.
Next reading
- Authentication — generating, rotating, and revoking API keys
- Endpoints — the surfaces and what each does
- OpenAPI — the machine-readable spec for generating client SDKs
- Webhooks — get notified when posts publish
- MCP — the AI-agent integration