API reference
MakeAIVideo Publishing API
Connect social accounts and post finished videos to them.
5 operations · https://app.makeaivideo.ai/api/v1
GET
/publishing/accountsreadConnected social accounts, the plan's account limit, and every platform
GET https://app.makeaivideo.ai/api/v1/publishing/accounts
Responses
200AccountsSocialAccounts403publishing_unavailable: publishing is not switched on for this workspaceErrorEnvelope503publishing_unreachable: the publishing service did not answer (retryable)ErrorEnvelope
POST
/publishing/accounts/connectwriteLink a PERSON opens to connect one OAuth account
POST https://app.makeaivideo.ai/api/v1/publishing/accounts/connect
Responses
200Link. A person must open `url` in a browser and approve; afterwards they land on the web app's Accounts page. Poll GET /publishing/accounts for the new account.403publishing_unavailableErrorEnvelope409account_limit: the plan's account limit is reached (details.limit)ErrorEnvelope422connect_in_web_app (Bluesky, Telegram, Discord)ErrorEnvelope502The publishing service refused or failed (retryable)ErrorEnvelope
POST
/videos/{id}/publishwritePost a finished video to connected accounts, now or scheduled (async)
POST https://app.makeaivideo.ai/api/v1/videos/{id}/publish
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| idrequired | path | string | Public video id, e.g. vid_abc123 |
Responses
202Accepted. Poll GET /publishing/posts/{id} until done is truePost400Video not ready, or a bad account idErrorEnvelope403publishing_unavailable, or the key lacks the write scopeErrorEnvelope404Unknown videoErrorEnvelope409no_accounts, account_unavailable (details.account_ids need reconnecting), or an idempotency_key still in flightErrorEnvelope422video_too_large (a platform's size or length limit, such as X's 140 seconds)ErrorEnvelope502The publishing service refused or failed (retryable)ErrorEnvelope
GET
/publishing/postsreadPublish history, newest first (keyset pagination)
GET https://app.makeaivideo.ai/api/v1/publishing/posts
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| limit | query | integer | — |
| cursor | query | string | next_cursor from the previous page |
| video_id | query | string | Only this video's posts |
Responses
200Posts
GET
/publishing/posts/{id}readOne post: status and per-destination results
GET https://app.makeaivideo.ai/api/v1/publishing/posts/{id}
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| idrequired | path | string | Publish job (post) id, e.g. pub_abc123 |
Responses
200PostPost404Unknown postErrorEnvelope
MakeAIVideo API guides
- Quickstart — the create, poll and download loop end to end.
- Authentication — what the read, write scope on this page mean.
- Agents — calling these endpoints from an autonomous agent.
Get an API key
The API and MCP server use the same credits and the same balance as the app, with no separate API plan. Create a key under Settings, Advanced, API keys.
7-day free trial with 350 credits, then plans from $9/mo. Cancel anytime before the trial ends.