Internet Tools

Guide

HTTP Client

The HTTP Client method allows you to construct and send HTTP requests similar to the cURL command-line tool and capture the response within the Execution State. This is useful for interacting with external APIs or web services from within your processes.

The response object includes three fields:

  • headers – A key-value dictionary containing the HTTP response headers.
  • status – An integer representing the HTTP status code.
  • body – The HTTP response body. If the content is JSON, it is automatically parsed into a structured object.

Input Parameters:

Name Description
URL The target URL for the HTTP request
Headers A list of request headers. Use the mapper input type, a string like [key1:value1,key2:value2], or an array of strings where each entry is formatted as "key:value".
Parameters A list of query parameters. These can also be defined using the mapper input type, a string like [key1:value1,key2:value2], or an array of "key:value" strings.
HTTP Method The HTTP method to use, such as GET, HEAD, POST, PUT, DELETE, or PATCH.
Body The request body content, used with methods like POST or PUT

Result Mapping

Define where the HTTP response should be saved in the Execution State using a JSON Path expression. This allows the response data to be reused later in the process, such as for decision-making, notifications, or data storage.