---
title: "Publish to many accounts"
method: POST
path: "/upload/bulk"
tags: ["Uploads"]
---

# Publish to many accounts

`POST /upload/bulk`

## Request

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

Publishes the same media to several connected accounts in one request. One upload job is created per account, so a failure on one account does not affect the others.

## Headers

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

## Response `200`

One result per requested account.

- object
  - `success` unknown
  - `message` string
  - `data` QueuedUpload[]
    - `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.
- `409`: A request with the same `Idempotency-Key` is still in progress. Retry later.
- `429`: Too many requests for this endpoint group.

---

[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)
