Deliver a request to an incoming webhook

​

Public endpoint of a WEBHOOK automatization trigger. Requires no authentication - the token in the path is the credential. The request is stored and answered immediately; the automatization's code actions run afterwards, so the response never carries their result. Any valid UTF-8 body is accepted: JSON is passed to the script decoded, anything else as a raw string. Bodies over 1 MB are rejected, and so is a body that is not valid UTF-8 (an ISO-8859-x payload, say) - re-encode it before sending.

Path Parameters
  • token
    Type: string
    required

    Token of the webhook, from the automatization's webhookUrl

Body
application/json

Whatever the sending system posts - this endpoint imposes no shape on it. A JSON body is decoded and reaches the code actions as input['body']; application/x-www-form-urlencoded is parsed into an object; any other content type (XML, plain text) arrives as a raw string. Bodies over 1 MB are rejected with 413; a body that is not valid UTF-8 is rejected with 400.

Any JSON object. A top-level array or scalar is accepted just as well and reaches the script unchanged.

  • propertyName
    Type: anything
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/hook/{token}
curl 'https://test.boost.space/api/hook/{token}' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "additionalProperty": "anything"
}'

{
  "code": 200,
  "status": "accepted",
  "deliveryId": 1234
}

Delivery accepted and queued for execution