HTTP Request Node

Make HTTP requests to any API or webhook endpoint.

Overview

The HTTP Request node lets you call any REST API. Configure the method, URL, headers, authentication, and body. The response is stored in context under your variable name.

Configuration

Variable Name

The key under which the response is stored in context. Default: httpRequest

Reference the output: {{variableName.httpResponse.data}}

Method

Supported: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS

URL

The endpoint URL. Supports template variables:

text

https://api.example.com/users/{{userId.httpResponse.data.id}}

Authentication

Type	Description
None	No authentication
Bearer Token	Authorization: Bearer {token}
Basic Auth	Base64 encoded username:password
API Key (Header)	Custom header with API key
API Key (Query)	API key appended to URL

Query Parameters

Key-value pairs appended to the URL automatically. Values support {{variables}}.

Headers

Custom request headers. Values support {{variables}}.

Body (POST / PUT / PATCH / DELETE)

Type	Description
JSON	Raw JSON with {{variables}} support
Form Data	Multipart form fields
URL Encoded	application/x-www-form-urlencoded
Raw	Plain text with custom Content-Type

Response Format

Value	Behavior
Auto	Detect from Content-Type header
JSON	Force JSON.parse
Text	Return raw text string

Advanced Settings

Name	Type	Required	Default	Description
`timeout`	`number`	No	`30000`	Request timeout in milliseconds
`followRedirects`	`boolean`	No	`true`	Follow HTTP redirects
`retryOnStatus`	`string`	No	—	Comma-separated status codes to retry, e.g. "429,503"
`maxRetries`	`number`	No	`0`	Max retry attempts (0-5)

Output Shape

json

{
  "[variableName]": {
    "httpResponse": {
      "data": {},
      "status": 200,
      "statusText": "OK",
      "ok": true,
      "headers": {},
      "url": "...",
      "method": "GET",
      "responseTime": 142
    }
  }
}

Examples

Fetch a user by ID and reference the response downstream.

Name	Type	Required	Default	Description
`variableName`	`string`	Yes	`userData`	Context key for the response
`method`	`string`	Yes	`GET`	HTTP method
`url`	`string`	Yes	—	https://api.example.com/users/1

Access the response: {{userData.httpResponse.data.name}}

Error Handling

Non-2xx responses throw a NonRetriableError by default. Enable "Continue on error" to handle failures gracefully.

Check {{variableName.httpResponse.ok}} in the next node to branch on success or failure.

Set Variable Code