API reference
Every REST API endpoint for IMMA AI, with request and response examples.
Preview
Preview: the API and MCP server are in private beta; details may change.
This section documents every endpoint of the IMMA AI REST API. Each page has the endpoint list, a request parameters table, copy-paste examples in curl, Node and Python, an example response, the errors it can return, and any platform specific rules.
Base URL
https://api.getimma.com/v1Before you start
- Authentication: API key types, scopes, and multi-tenant profiles.
- Idempotency: how
Idempotency-Keyprotects everyPOSTfrom duplicates. - Pagination: cursor pagination for list endpoints.
- Errors: the error shape and HTTP status codes every endpoint shares.
If you have not made a call yet, the Quickstart walks through getting a key, connecting an account, and publishing a post end to end. Concepts explains the six objects (workspace, profile, account, post, target, approval) that every endpoint below operates on.
Resources
| Page | Covers |
|---|---|
| Accounts | Connecting TikTok, Instagram, Facebook Pages and Threads accounts, and reading their capabilities and quota |
| Media | Uploading and importing images and video, including inline data from an AI agent |
| Posts | Creating, validating, listing, updating, cancelling and retrying posts |
| Posts batch | Creating up to 31 posts in one call, for a month of content at once |
| Approvals | Reading approval status and resending an approval link |
| Calendar | Reading scheduled, published and draft slots in one call |
| Analytics | Post and account metrics |
| Comments | Reading and replying to comments on Facebook, Instagram and Threads |
| Webhooks | Managing outgoing webhook endpoints |
For a full walkthrough of event types and signature verification, see Webhooks. For TikTok consent and platform posting limits, see Platform rules.