MakeAIVideo

API reference

MakeAIVideo Publishing API

Connect social accounts and post finished videos to them.

5 operations · https://app.makeaivideo.ai/api/v1

GET/publishing/accountsread

Connected social accounts, the plan's account limit, and every platform

GET https://app.makeaivideo.ai/api/v1/publishing/accounts

Responses

  • 200AccountsSocialAccounts
  • 403publishing_unavailable: publishing is not switched on for this workspaceErrorEnvelope
  • 503publishing_unreachable: the publishing service did not answer (retryable)ErrorEnvelope
POST/publishing/accounts/connectwrite

Link 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_unavailableErrorEnvelope
  • 409account_limit: the plan's account limit is reached (details.limit)ErrorEnvelope
  • 422connect_in_web_app (Bluesky, Telegram, Discord)ErrorEnvelope
  • 502The publishing service refused or failed (retryable)ErrorEnvelope
POST/videos/{id}/publishwrite

Post a finished video to connected accounts, now or scheduled (async)

POST https://app.makeaivideo.ai/api/v1/videos/{id}/publish

Parameters

NameInTypeDescription
idrequiredpathstringPublic video id, e.g. vid_abc123

Responses

  • 202Accepted. Poll GET /publishing/posts/{id} until done is truePost
  • 400Video not ready, or a bad account idErrorEnvelope
  • 403publishing_unavailable, or the key lacks the write scopeErrorEnvelope
  • 404Unknown videoErrorEnvelope
  • 409no_accounts, account_unavailable (details.account_ids need reconnecting), or an idempotency_key still in flightErrorEnvelope
  • 422video_too_large (a platform's size or length limit, such as X's 140 seconds)ErrorEnvelope
  • 502The publishing service refused or failed (retryable)ErrorEnvelope
GET/publishing/postsread

Publish history, newest first (keyset pagination)

GET https://app.makeaivideo.ai/api/v1/publishing/posts

Parameters

NameInTypeDescription
limitqueryinteger—
cursorquerystringnext_cursor from the previous page
video_idquerystringOnly this video's posts

Responses

  • 200Posts
GET/publishing/posts/{id}read

One post: status and per-destination results

GET https://app.makeaivideo.ai/api/v1/publishing/posts/{id}

Parameters

NameInTypeDescription
idrequiredpathstringPublish job (post) id, e.g. pub_abc123

Responses

  • 200PostPost
  • 404Unknown 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.