Uploads

Publish to one account

Publishes a video, photo or text post to a single connected account.

Media can be sent either as a file part or as a publicly reachable URL string in the same field. Platforms that accept text-only posts (Facebook, LinkedIn, Bluesky, Threads) may omit media entirely.

A file part sent here must stay under 100 MB: the request body is capped at that size by our edge and a bigger one is rejected with 413 before it reaches the API. That cap is an edge limit, not a platform one - to publish larger media, get a URL from POST /upload/presign and send it in the same field.

The request returns as soon as the job is queued. Supply schedule_date (or scheduledDate for YouTube) to publish later. Platform-specific fields are ignored by platforms that do not support them.

post/upload

Request

  • Base URL: https://api.multi-upload-tool.com/api/v1
  • URL: https://api.multi-upload-tool.com/api/v1/upload
  • Auth: API key in header x-api-key

Query parameters

asyncstring

Set to false to wait for the post to finish publishing instead of returning once queued.

Headers

X-Team-IDinteger

Act inside this team. Ignored when the token is already pinned to a team; membership is verified on every request.

Idempotency-Keystring

Unique value (e.g. a UUID) per intended post. A retry with the same key within 24 hours returns the first response, with the Idempotent-Replay: true header, instead of publishing again.

Response

The post was queued, scheduled, or (when async=false) published.

successunknown required
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.