HTTP Request

How to Send a Request

Send Request: Send an HTTP request to the server to fetch or submit data.

Method: Select the HTTP method, such as GET (to fetch data) or POST (to send data).

Destination URL: Enter the URL of the server you want to send the request to.


Content Type

Select the data format to be sent. There are 4 options:

  • text/plain: Plain text without special formatting

  • application/json: JSON format, commonly used for structured data

  • multipart/form-data: Used to send multiple parts of data, such as file uploads

  • application/x-www-form-urlencoded: Encodes data in URL format; all characters will be URL-encoded (default if no type is specified)


Timeout

Set the timeout for the HTTP request. Choose 0 if no timeout is needed.


Headers

This section is commonly used for API authentication by adding required headers.


Expected Response Type

Choose how the API response should be interpreted:

  • JSON – Structured data commonly used in APIs

  • Text – Plain text response

  • Base64 – Encoded binary data, often used for images or file transfers


Headers for Authentication

To authenticate when using an API, if required. For example, to use a Bearer token:

Authorization: Bearer hfkasf2938safjkb,bfclsaidfcf,jsacbliwgsbdcjsacsdakhfasjbasdfhfakjsfdbcasdfgasfbasdfhbfcbashdagdkbsajfhgdsb.

Writing Command in the Body

When writing logic in the request body to access data such as variables or tables, the final output must be a valid JSON to avoid errors, since this content is usually strictly formatted.


Multi-line Strings

If the data you're referencing contains line breaks, use an exclamation mark ! before the keyword. Example:

{
   "longText": {{!$stringify([variables.src])}}
}

Other Data Types

If the data is an object, array, etc., you can directly write {} inside the body. Example:

{
   "profile": {{$stringify[variables.userProfile]}}, 
   "stats": {{$stringify[variables.stats]}}
}

Handling the Response

Once the API response is received, you must process it appropriately.


Response Type

The response type is usually JSON.


Data Path

Define the path of the specific data you want to extract. For example, if the API returns:

{
   "status": 200,
   "data": {
      "name": "Prices",
      "values": [
         { "id": 1, "value": 4000 },
         { "id": 2, "value": 24000 }
      ]
   }
}
  • To access the values array: use data.values

  • To access the first item in the array: use data.values.0

  • If you want to use all returned data, you can skip setting the data path.


Assigning to Variable

You can assign the received data to a variable.

  • Variable name – The name of the variable to store the result

  • Insert into table – You can insert the value into a column in a table

  • Select column – Choose the column you want to insert into

  • Add row – Add a new row to the table with the incoming data


Last updated