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
Every plan includes API and MCP access on the same credits as the app. Create a key under Settings, Advanced, API keys.
Plans from $9 a month, with the allowance topped back up each billing month.