---
title: "Publish to one account"
method: POST
path: "/upload"
tags: ["Uploads"]
---

# Publish to one account

`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`

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.

## Query parameters

- `async` string

## Headers

- `X-Team-ID` integer
- `Idempotency-Key` string

## Response `200`

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

- object
  - `success` unknown, required
  - `message` string, required
  - `data` QueuedUpload, required
    - `uploadId` integer
    - `status` 'pending' | 'scheduled' | 'processing' | 'completed' | 'failed' | 'draft' | 'pending_approval'
    - `scheduledFor` string, date-time, nullable
    - `jobId` string, nullable: Background job handle.

## Other responses

- `400`: The request body or parameters were rejected.
- `401`: The API key is missing, invalid, revoked or expired.
- `404`: The account does not exist, is inactive, or is not owned by the caller.
- `409`: A request with the same `Idempotency-Key` is still in progress. Retry later.
- `429`: Rate limit exceeded, or the account reached its daily platform limit.

---

[API](https://skmtc.dev/multi-upload-tool/apis/multi-upload-tool-api.md) · [All operations](https://skmtc.dev/multi-upload-tool/apis/multi-upload-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/multi-upload-tool/apis/multi-upload-tool-api/revisions/bb7e72abbb76?raw)