Multi Upload Tool Webhooks API

Event notifications delivered to your endpoint.

GitHub OpenAPI

Operations 8

GET /webhooks List webhooks #
POST /webhooks Create a webhook #
DELETE /webhooks/{id} Delete a webhook #
PATCH /webhooks/{id} Enable or disable a webhook #
GET /webhooks/{id}/deliveries List delivery attempts #
POST /webhooks/{id}/deliveries/{deliveryId}/replay Replay a delivery #
POST /webhooks/{id}/rotate-secret Rotate the signing secret #
POST /webhooks/{id}/test Send a test delivery #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/multi-upload-tool-com:multi-upload-tool-com-webhooks-api"
All apis
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.

Get an API 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 Specification

multi-upload-tool-com-webhooks-api-openapi.yml Raw ↑
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