Skip to main content
POST
Run a webhook automation on posted files

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Request-Id
string

Your own id for this request — 8 to 128 letters, digits, ., _, : or -. Used in place of one we mint, and echoed back.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Idempotency-Key
string

Retry this POST safely: the first request with a key runs and its answer is kept for a day; a retry with the same key and the same request gets that answer again, marked Idempotent-Replayed: true, instead of running twice. 1–255 printable characters — a UUID is a good one.

Required string length: 1 - 255

Path Parameters

token
string
required

The link's token, mmt_….

Body

application/json
url
string<uri>
urls
string<uri>[]
Maximum array length: 20
inputs
object

Values for the steps' {{names}}, like {"title": "Summer sale"}. A required input with no default has to be sent; a name the steps don't use is refused. describe_recipe, or GET /api/v1/recipes/{ref}, lists them under inputs. In a multipart form, send a JSON string or one field per input, inputs[title].

Response

Nothing started — every file was skipped. The automation's runs say why.

started
integer
required

Runs started, one a file.

skipped
integer
required

Files skipped, each with its reason in the runs.