REST API overview
The Warmup REST API gives your code the same capabilities as the dashboard: projects, social network connections, publishing and analytics.
Basics
Section titled “Basics”| Base URL | https://api.warmup.social |
| Format | JSON in and out; image upload uses multipart/form-data |
| Authentication | Authorization: Bearer wmp_… — see Authentication |
| Dates | YYYY-MM-DD for periods, ISO 8601 UTC (2026-10-01T12:00:00.000Z) for timestamps |
| Ids | UUIDs |
| Specification | OpenAPI 3 |
curl https://api.warmup.social/projects \ -H "Authorization: Bearer wmp_YOUR_TOKEN"Resources
Section titled “Resources”| Resource | Endpoints |
|---|---|
| Projects | GET /projects, POST /projects, GET · PATCH · DELETE /projects/{id} |
| Connections | POST /projects/{id}/connections/{platform}/start, DELETE /projects/{id}/connections/{platform}, Facebook Page selection |
| Publications | POST /projects/{id}/media, POST · GET /projects/{id}/publications, GET /projects/{id}/publications/{publicationId} |
| Analytics | GET /analytics/filters · overview · platforms · top-posts · content · duration · activity |
| Tracked accounts | GET · POST /accounts, PATCH · DELETE /accounts/{platform}/{username} |
| API tokens | GET · POST /api-tokens, DELETE /api-tokens/{id} |
Limits
Section titled “Limits”- Publishing — image upload and creating publications — is limited to 30 requests per minute per user. Over the limit the API answers
429. - A project’s networks are limited to Facebook, Instagram and Threads; analytics covers Instagram, TikTok and Facebook.
- The number of projects depends on your plan.
Publish a postUpload an image, create a publication and wait for the result.
Read analyticsPeriods, filters and how the metrics are calculated.