Multi Upload Tool Webhooks API
Event notifications delivered to your endpoint.
Event notifications delivered to your endpoint.
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-webhooks-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 Webhooks 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: Webhooks
description: Event notifications delivered to your endpoint.
paths:
/webhooks:
get:
tags:
- Webhooks
summary: List webhooks
description: Returns every webhook registered by the caller, with the events each one subscribes to.
operationId: listWebhooks
x-required-scope: webhooks:read
parameters:
- $ref: '#/components/parameters/TeamId'
responses:
'200':
description: The caller's webhooks.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: array
items:
$ref: '#/components/schemas/Webhook'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
post:
tags:
- Webhooks
summary: Create a webhook
description: Registers an endpoint to receive the selected events. Team members with the `MEMBER` role cannot create webhooks.
operationId: createWebhook
x-required-scope: webhooks:write
parameters:
- $ref: '#/components/parameters/TeamId'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- url
- events
properties:
url:
type: string
format: uri
description: HTTPS endpoint that will receive the event payloads.
events:
type: array
minItems: 1
items:
$ref: '#/components/schemas/WebhookEvent'
secret:
type: string
description: Shared secret used to sign deliveries.
responses:
'200':
description: The created webhook.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
$ref: '#/components/schemas/Webhook'
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
/webhooks/{id}:
delete:
tags:
- Webhooks
summary: Delete a webhook
description: Removes the webhook. Deliveries stop immediately; past deliveries are unaffected.
operationId: deleteWebhook
x-required-scope: webhooks: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'
'429':
$ref: '#/components/responses/RateLimited'
patch:
tags:
- Webhooks
summary: Enable or disable a webhook
description: Re-enables a webhook disabled after 3 events in a row failed every delivery attempt (and resets that count), or pauses one without deleting it.
operationId: setWebhookActive
x-required-scope: webhooks:write
parameters:
- name: id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/TeamId'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- isActive
properties:
isActive:
type: boolean
responses:
'200':
description: The updated webhook.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
$ref: '#/components/schemas/Webhook'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
/webhooks/{id}/deliveries:
get:
tags:
- Webhooks
summary: List delivery attempts
description: 'Every delivery attempt, newest first, kept 30 days. One row per attempt: an event that failed twice then succeeded has 3 rows with the same `eventId`. A failed attempt is retried after 30 s, 2 min, 10 min, 1 h and 6 h.'
operationId: listWebhookDeliveries
x-required-scope: webhooks:read
parameters:
- name: id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/TeamId'
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 200
default: 50
responses:
'200':
description: Delivery attempts.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: array
items:
$ref: '#/components/schemas/WebhookDelivery'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
/webhooks/{id}/deliveries/{deliveryId}/replay:
post:
tags:
- Webhooks
summary: Replay a delivery
description: Sends the event of that delivery again, with its original event id so your endpoint can deduplicate. The replay gets its own attempts and retries. Returns 409 when the webhook is disabled.
operationId: replayWebhookDelivery
x-required-scope: webhooks:write
parameters:
- name: id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/TeamId'
- name: deliveryId
in: path
required: true
schema:
type: integer
responses:
'200':
description: The event is queued again.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: object
properties:
eventId:
type: string
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'409':
description: The webhook is disabled.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
$ref: '#/components/responses/RateLimited'
/webhooks/{id}/rotate-secret:
post:
tags:
- Webhooks
summary: Rotate the signing secret
description: Generates a new signing secret, effective immediately (retries already queued are signed with it too), and returns it.
operationId: rotateWebhookSecret
x-required-scope: webhooks:write
parameters:
- name: id
in: path
required: true
schema:
type: integer
- $ref: '#/components/parameters/TeamId'
responses:
'200':
description: The new secret.
content:
application/json:
schema:
type: object
properties:
success:
const: true
data:
type: object
properties:
secret:
type: string
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
/webhooks/{id}/test:
post:
tags:
- Webhooks
summary: Send a test delivery
description: Delivers a sample payload to the webhook so you can verify signing and connectivity.
operationId: testWebhook
x-required-scope: webhooks: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'
'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
ValidationError:
description: The request body or parameters were rejected.
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/Error'
- $ref: '#/components/schemas/FieldValidationError'
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'
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
schemas:
WebhookEvent:
type: string
enum:
- upload.completed
- upload.failed
- upload.scheduled
- upload.cancelled
- upload.approved
- upload.changes_requested
- connected_account.expired
- connected_account.refresh_failed
- connected_account.connected
- connected_account.disconnected
- subscription.created
- subscription.updated
- subscription.cancelled
- subscription.expired
- subscription.revoked
- upsell.purchased
- upsell.subscription.created
- upsell.subscription.revoked
- suggestion.created
- suggestion.updated
- security.login
- team.invite
- webhook.disabled
WebhookDelivery:
type: object
description: One delivery attempt.
properties:
id:
type: integer
eventId:
type: string
description: The payload id, identical across retries and replays.
event:
$ref: '#/components/schemas/WebhookEvent'
attempt:
type: integer
description: 1 to 6 within one delivery.
success:
type: boolean
statusCode:
type:
- integer
- 'null'
error:
type:
- string
- 'null'
durationMs:
type:
- integer
- 'null'
payload:
type: object
createdAt:
type: string
format: date-time
FieldValidationError:
type: object
required:
- success
- message
- errors
properties:
success:
const: false
message:
const: Validation Error
errors:
type: array
items:
type: object
properties:
path:
type: string
message:
type: string
summary:
type: string
Error:
type: object
required:
- success
- error
properties:
success:
const: false
error:
type: string
description: Human-readable failure reason.
statusCode:
type: integer
Webhook:
type: object
properties:
id:
type: integer
url:
type: string
format: uri
events:
type: array
items:
$ref: '#/components/schemas/WebhookEvent'
isActive:
type: boolean
createdAt:
type: string
format: date-time
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