Multi Upload Tool Accounts API
Connected social media accounts.
Connected social media accounts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/multi-upload-tool-com:multi-upload-tool-com-accounts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Multi Upload Tool Accounts API
version: 1.0.0
summary: Publish and schedule video and photo posts to TikTok, YouTube, Instagram, Facebook, LinkedIn, Pinterest, Bluesky and Threads from one API.
description: 'REST API for the Multi Upload Tool platform.
Upload a video or photo once and publish it to one or many connected social accounts, immediately or on a schedule. The API also covers connected-account management, upload history, per-account daily limits, webhooks, teams, white-label connection links, short links and custom domains.
## Authentication
Every endpoint requires an API token sent in the `x-api-key` header. Tokens are created from the dashboard and look like `kmb_`.
```
x-api-key: kmb_0123456789abcdef...
```
## Permission model
A token carries **scopes**, chosen when it is created in the dashboard. `*` grants everything: it is what every token created before scopes existed holds, and what a token created without a list gets. Otherwise the token holds `resource:action` scopes — `posts:read`, `posts:write`, `posts:publish`, `accounts:read`, `accounts:write`, `analytics:read`, `pools:read`, `pools:write`, `webhooks:read`, `webhooks:write`, `team:read`, `team:write`, `links:read`, `links:write`. `write` includes `read`, and `posts:publish` includes `posts:write`. A token with `posts:write` but not `posts:publish` can create posts, but they are always held for approval. Each operation states what it needs in `x-required-scope`; a call without it returns `403` with `code: INSUFFICIENT_SCOPE` and `requiredScope`.
On top of scopes, **team scoping** applies.
- A token created against a team is permanently pinned to that team. It can only read and write that team''s resources, and it is revoked automatically if the user leaves the team.
- An unscoped token may target a team per-request with the `X-Team-ID` header. Membership is verified on every call.
- Inside a team, the member''s role (`OWNER`, `ADMIN`, `MEMBER`) gates privileged operations. Members cannot create webhooks; only owners and admins can invite or remove members; only an owner can remove an admin.
Treat an API token as a credential and store it accordingly; give each integration only the scopes it needs.
## Large media
A file part sent to `POST /upload` must stay under 100 MB, an edge limit on the request body rather than a platform one. For anything larger, call `POST /upload/presign` to get URLs that put the bytes straight into storage, then publish by passing the returned `bucketUrl` (preferred for large video) or `accessUrl` in the `video`, `photo` or `file` field.
## Rate limits
Limits are applied per IP and per endpoint group; exceeding one returns `429`. The tightest limits are on writes: 50 requests / 15 min for `POST /upload`, 20 requests / 15 min for `POST /upload/bulk` and for destructive operations. Reads are typically 100 requests / 5-15 min. A single IP may also present at most 10 distinct API tokens per hour.
## Errors
Errors return a JSON body of the form `{ "success": false, "error": "..." }`. Validation failures on `POST /upload` additionally return a per-field `errors` array.'
termsOfService: https://multi-upload-tool.com/terms
contact:
name: Multi Upload Tool support
url: https://multi-upload-tool.com/about
email: support@multi-upload-tool.com
servers:
- url: https://api.multi-upload-tool.com/api/v1
description: Production
security:
- apiKey: []
tags:
- name: Accounts
description: Connected social media accounts.
paths:
/accounts:
get:
tags:
- Accounts
summary: List connected accounts
description: Returns every social account connected to the caller, or to the team when the request is team-scoped.
operationId: listAccounts
x-required-scope: accounts:read
parameters:
- $ref: '#/components/parameters/TeamId'
- name: platform
in: query
required: false
description: Only return accounts on this platform.
schema:
$ref: '#/components/schemas/Platform'
- name: status
in: query
required: false
description: Only return accounts in this connection state.
schema:
$ref: '#/components/schemas/AccountStatus'
- name: tags
in: query
required: false
description: Only return accounts whose tag list contains this substring.
schema:
type: string
responses:
'200':
description: The matching connected accounts.
content:
application/json:
schema:
type: object
required:
- success
- data
- count
properties:
success:
const: true
data:
type: array
items:
$ref: '#/components/schemas/Account'
count:
type: integer
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
/accounts/{id}:
parameters:
- name: id
in: path
required: true
description: Connected account identifier.
schema:
type: string
get:
tags:
- Accounts
summary: Get a connected account
description: Returns a single connected account, including its current connection state.
operationId: getAccount
x-required-scope: accounts:read
parameters:
- $ref: '#/components/parameters/TeamId'
responses:
'200':
description: The connected account.
content:
application/json:
schema:
type: object
required:
- success
- data
properties:
success:
const: true
data:
$ref: '#/components/schemas/Account'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
delete:
tags:
- Accounts
summary: Disconnect an account
description: Revokes the stored credentials and removes the account. Already published posts are unaffected.
operationId: deleteAccount
x-required-scope: accounts:write
parameters:
- $ref: '#/components/parameters/TeamId'
responses:
'200':
$ref: '#/components/responses/Success'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
/accounts/linkedin/pages:
get:
tags:
- Accounts
summary: List LinkedIn pages
description: Returns the LinkedIn organization pages the connected account can publish to.
operationId: listLinkedInPages
x-required-scope: accounts:read
parameters:
- $ref: '#/components/parameters/TeamId'
- name: accountId
in: query
required: true
description: A connected LinkedIn account.
schema:
type: string
responses:
'200':
description: The organization pages available to that account.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: array
items:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
/pinterest/boards:
get:
tags:
- Accounts
summary: List Pinterest boards
description: Returns the boards a connected Pinterest account can pin to. Use a board id as `pinterest_board_id` when publishing.
operationId: listPinterestBoards
x-required-scope: accounts:read
parameters:
- $ref: '#/components/parameters/TeamId'
- name: accountId
in: query
required: true
schema:
type: string
responses:
'200':
description: The account's boards.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: array
items:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
components:
responses:
NotFound:
description: No such resource, or it does not belong to the caller.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Success:
description: The operation succeeded.
content:
application/json:
schema:
type: object
properties:
success:
const: true
message:
type: string
Unauthorized:
description: The API key is missing, invalid, revoked or expired.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Forbidden:
description: The token is valid but not permitted to act on this resource, usually because of team scoping or the caller's team role.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
RateLimited:
description: Too many requests for this endpoint group.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
AccountStatus:
type: string
description: Connection state of a social account. Only `active` accounts can publish.
enum:
- active
- expired
- revoked
- inactive
Platform:
type: string
description: A supported social platform.
enum:
- tiktok
- youtube
- instagram
- facebook
- linkedin
- pinterest
- bluesky
- threads
- x
Error:
type: object
required:
- success
- error
properties:
success:
const: false
error:
type: string
description: Human-readable failure reason.
statusCode:
type: integer
Account:
type: object
properties:
id:
type: string
platform:
$ref: '#/components/schemas/Platform'
accountName:
type: string
description: Display name or handle on the platform.
profileImageUrl:
type:
- string
- 'null'
format: uri
status:
$ref: '#/components/schemas/AccountStatus'
tags:
type: array
items:
type: string
parameters:
TeamId:
name: X-Team-ID
in: header
required: false
description: Act inside this team. Ignored when the token is already pinned to a team; membership is verified on every request.
schema:
type: integer
securitySchemes:
apiKey:
type: apiKey
in: header
name: x-api-key
description: 'API token created from the dashboard, in the form `kmb_<64 hex characters>`.
A token carries a list of scopes, chosen when it is created: `*` (everything — every token created before scopes existed, and any token created without a list) or `resource:action` scopes such as `posts:read` or `analytics:read`. Each operation states the scope it needs in `x-required-scope`; a token without it gets `403` with `code: INSUFFICIENT_SCOPE`. A token with `posts:write` but not `posts:publish` can create posts, which are always held for approval. On top of scopes, team scoping applies: baked into the token at creation time or requested per-call with `X-Team-ID`. Store it as you would a password.'
externalDocs:
description: Full API documentation
url: https://docs.multi-upload-tool.com/api-reference