HTTP Request (Throttled)

Makes an HTTP request with automatic rate-limit throttling

HTTP Request (Throttled)

AI-generated

Summary

Sends an HTTP request using the selected method and URL, with optional authentication, headers, and body. When throttling is enabled, it waits and retries on configured status codes, using response headers to determine the wait when available.

Inputs

  • Method — HTTP method: GET by default, or DELETE, HEAD, OPTIONS, PATCH, POST, or PUT.
  • URL (required) — The request URL.
  • Authentication — Choose None, Basic Auth, Header Auth, OAuth1, or OAuth2; configure the corresponding n8n credentials when using authentication.
  • Send Headers — Enable to add one or more request headers as name and value pairs.
  • Send Body — Enable to send a body. Choose JSON, Form Urlencoded, or Raw, then enter the body. JSON input is parsed as JSON when possible.
  • Enable Throttling — On by default. When enabled, retry responses with selected HTTP codes; the default trigger is 429. Throttling Settings lets you select trigger codes (429, 503, or 504), set a default wait of 5000 ms, add up to 25% random jitter, and set a maximum of 5 retries.

Output shape

A list of items containing the HTTP response body as JSON.

The underlying HTTP Request V3 implementation handles the request and response. In the fallback implementation, object bodies are returned directly and other body values are wrapped as {"data": value}; HTTP errors throw unless Continue On Fail is enabled. Throttling waits use Retry-After or rate-limit reset headers when available, otherwise the configured default; waits are capped at five minutes. Exhausting the retry limit throws an error.

Links

Discussion