Multi Upload Tool Domains API
Custom domains for short links.
Custom domains for short links.
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-domains-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 Domains 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: Domains
description: Custom domains for short links.
paths:
/domains:
get:
tags:
- Domains
summary: List custom domains
description: Returns the custom short-link domains registered by the caller and whether each is verified.
operationId: listDomains
x-required-scope: links:read
parameters:
- $ref: '#/components/parameters/TeamId'
responses:
'200':
description: The caller's custom short-link domains.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: array
items:
$ref: '#/components/schemas/Domain'
'401':
$ref: '#/components/responses/Unauthorized'
post:
tags:
- Domains
summary: Add a custom domain
description: Registers a domain for short links. Point it at the platform with a CNAME, then call the verify endpoint.
operationId: createDomain
x-required-scope: links:write
parameters:
- $ref: '#/components/parameters/TeamId'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- domain
properties:
domain:
type: string
examples:
- links.example.com
teamId:
type: integer
description: Team to attach the domain to. Must match the token's team when the token is team-scoped.
responses:
'200':
description: The registered domain and the DNS record to create.
content:
application/json:
schema:
$ref: '#/components/schemas/Domain'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
/domains/{id}:
delete:
tags:
- Domains
summary: Delete a custom domain
description: Removes the custom domain from the account.
operationId: deleteDomain
x-required-scope: links:write
parameters:
- name: id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/TeamId'
responses:
'200':
$ref: '#/components/responses/Success'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
/domains/{id}/verify:
post:
tags:
- Domains
summary: Verify a custom domain
description: Checks that the domain's DNS points at the platform and activates it.
operationId: verifyDomain
x-required-scope: links:write
parameters:
- name: id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/TeamId'
responses:
'200':
description: The verification result.
content:
application/json:
schema:
$ref: '#/components/schemas/Domain'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
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'
schemas:
Domain:
type: object
properties:
id:
type: integer
domain:
type: string
verified:
type: boolean
createdAt:
type: string
format: date-time
Error:
type: object
required:
- success
- error
properties:
success:
const: false
error:
type: string
description: Human-readable failure reason.
statusCode:
type: integer
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