request: post json

This block is part of the webhooks group and was last modified in core v15.0.0.

request: post json number v12.1.6 Updated v15.0.0

Performs an HTTP POST request to create or submit data to the specified URL with a JSON body.

In pins 12 + flow

flow
flow
URL required
value
body required
object
Auth. header
value
Hidden when unused
Query String
object
Hidden when unused
headers
object
Hidden when unused
skip ssl
condition
true will skip SSL verification • Hidden when unused
include token v12.1.6
condition
true will include current users access token in header, to support internal RUAL endpoints requests • Hidden when unused
timeout v14.0.1
number
Overwrites the default timeout. Time in seconds. • Hidden when unused
retry v14.0.4
condition
Enable automatic retry on failure. Uses exponential backoff. • Hidden when unused
Default false
retry count v14.0.4
number
Maximum number of retry attempts. Default is 3. • Hidden when unused
Default 3
retry delay v14.0.4
number
Initial delay between retries in seconds. Uses exponential backoff (delay doubles each retry). • Hidden when unused
Default 1
signing key v15.0.0
value
When set, signs the request with HMAC-SHA256 for RUAL-internal APIs (e.g. the mssgs backend): adds X-Mssgs-Timestamp (Unix seconds) and X-Mssgs-Signature: sha256=<hex> computed over timestamp\nmethod\nrequest URI\nbody. • Hidden when unused

Out pins 3 + flow

request

http post json

A typical wiring for Request: POST json: new object feeds the body pin; dynamic value feeds the url pin; the flow out pin feeds return; the code out pin feeds reply in JSON.

Studio canvas example for the Request: POST json block: typical wiring for Request: POST json.

In production blueprints, this block is most often wired together with:

new object: feeds into this block. Builds a new object filled with the given fields.
return: this block feeds into it. Returns the added custom pins as data-pins on the function execute.
create: feeds into this block. Creates a new function that can be executed using the given name.
dynamic value: feeds into this block. Returns the provided value with support for dynamic inpins using {name:type} placeholders — the pin's name first, then its type, e.g. {guid:value}.
reply in JSON: this block feeds into it. Reply to any httpconnection as JSON body.
value: feeds into this block. Simply returns the provided value.

Introduced in v12.1.6.

Last modified in v15.0.0.

Cluster