Description

Make an HTTP request to an external API. Supports auth (Basic/Bearer/API Key/Custom), structured body (JSON/Form/Multipart/Raw/Binary), dedicated query parameters, automatic pagination (page/offset/cursor/link-header), retry with backoff, selectable response format (auto/json/text/binary), follow redirects and timeout.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`method` Metodo HTTP	`enum` `GETPOSTPUTPATCHDELETEHEADOPTIONS`	yes	`GET`	GET=leggi · POST=crea · PUT/PATCH=aggiorna · DELETE=cancella · HEAD=solo headers · OPTIONS=preflight CORS.
`url` URL	`string`	yes	— https://api.example.com/v1/users/{{input.id}}	URL completo (http o https). Supporta {{espressioni}} per pezzi dinamici.
`authMode` Autenticazione	`enum` `nonebasicbearerapikey-headercustom`	no	`none`	none = nessuna (o gestita via Headers). basic = HTTP Basic (user+password → Base64). bearer = "Authorization: Bearer <token>" (JWT, OAuth access tokens). apikey-header = header custom con il valore (X-API-Key, X-Auth-Token, ecc). custom = nome+valore header completamente liberi.
`basicUser` Username (Basic)	`string`	no	—	—
`basicPass` Password (Basic)	`string (encrypted)`	no	—	—
`bearerToken` Token Bearer	`string (encrypted)`	no	—	Il token segreto da mettere dopo "Bearer ".
`apiKeyHeaderName` Nome header API Key	`string`	no	`X-API-Key` X-API-Key oppure X-Auth-Token	—
`apiKeyValue` Valore API Key	`string (encrypted)`	no	—	—
`customAuthHeaderName` Nome header custom	`string`	no	`Authorization`	—
`customAuthHeaderValue` Valore header custom	`string (encrypted)`	no	—	—
`queryParamsJson` Query Parameters	`key-value`	no	—	Aggiunti all'URL come ?key=value&... Supportano {{espressioni}}.
`headersJson` Headers HTTP extra	`key-value`	no	—	Coppie nome-valore extra (Authorization e Content-Type sono gestiti automaticamente).
`bodyType` Tipo body	`enum` `nonejsonform-urlencodedmultipartraw-textraw-binary-base64binary`	no	`json`	none = nessun body (GET/HEAD/DELETE tipicamente). json = JSON (Content-Type application/json). form-urlencoded = form classico (key=value&...). multipart = form-data con file/binary support. raw-text = testo grezzo (per XML, YAML, custom). raw-binary-base64 = bytes binari (body in base64, viene decodificato). binary = UPLOAD ref-primario: il body sono i byte di un handle BinaryData in INPUT (da Read File / http download / pdf / imap); Content-Type dal mimeType dell'handle.
`body` Body (JSON o testo)	`code`	no	— { "key": "{{input.value}}" }	Per json: JSON. Per raw-text: testo libero. Per raw-binary-base64: stringa base64.
`rawBinaryContentType` Content-Type del binario	`enum` `application/octet-streamapplication/pdfimage/pngimage/jpegapplication/zip`	no	`application/octet-stream`	—
`formFields` Form fields (key-value)	`key-value`	no	—	Coppie nome-valore del form. Per multipart con file: il valore puo` essere base64.
`paginationMode` Pagination	`enum` `nonepage-numberoffset-limitcursorlink-header`	no	`none`	none = singola chiamata. page-number = ?page=1&limit=N, ?page=2&limit=N, ... (stop quando items < limit). offset-limit = ?offset=0&limit=N, ?offset=N&limit=N, ... cursor = leggi next_cursor dalla risposta, passa come ?cursor=... link-header = segui Link: <url>; rel="next" (GitHub, Mastodon).
`paginationMaxPages` Max pagine	`number`	no	`10`	Limite di sicurezza — interrompe il loop anche se ci sono altre pagine.
`paginationPageSize` Items per pagina (limit)	`number`	no	`50`	—
`paginationItemsField` Campo array nella risposta	`string`	no	— es. data, items, results	Se valorizzato, concatena response[campo]. Se vuoto, concatena l'intera response.
`paginationPageParam` Nome parametro pagina	`string`	no	`page`	—
`paginationStartPage` Pagina iniziale	`number`	no	`1`	—
`paginationLimitParam` Nome parametro limit	`string`	no	`limit`	—
`paginationOffsetParam` Nome parametro offset	`string`	no	`offset`	—
`paginationStartOffset` Offset iniziale	`number`	no	`0`	—
`paginationCursorParam` Nome parametro cursor	`string`	no	`cursor`	—
`paginationCursorField` Campo next cursor nella risposta	`string`	no	`next_cursor`	Es. next_cursor, nextPage, paging.next.cursor
`retryCount` Numero retry	`number`	no	`0`	Quante volte ritentare in caso di errore (5xx o codici configurati). 0 = no retry.
`retryInitialDelayMs` Delay iniziale (ms)	`number`	no	`500`	Pausa prima del primo retry. Si moltiplica per il fattore ad ogni tentativo.
`retryBackoffFactor` Fattore backoff esponenziale	`number`	no	`2`	2 = raddoppia ogni retry (500ms, 1000ms, 2000ms, ...). 1 = delay costante.
`retryOnStatus` Status da ritentare (csv)	`string`	no	`429,500,502,503,504` 429,500,502,503,504	Codici HTTP che fanno scattare il retry. Errori di network/timeout sono sempre ritentati.
`responseFormat` Formato risposta	`enum` `autojsontextbinary`	no	`auto`	auto = sniff dal Content-Type (default; octet-stream → handle binary). json = parse forzato (errore se non valido). text = stringa raw. binary = download come HANDLE BinaryData (ref content-addressed su disco): i byte NON entrano nel JSON → per PDF/immagini/file, anche grandi. Si collega a Write File / email / pdf / excel che consumano BinaryData (senza store: inline base64, fail-soft).
`followRedirects` Segui redirect	`boolean`	no	`true`	Se on: segue 3xx automaticamente. Se off: restituisce status 3xx e header Location.
`allowSelfSigned` Accetta certificati self-signed	`boolean`	no	`false`	SOLO per dev/test. NON usare in produzione.
`statusCodeOnly` Solo status code (ignora body)	`boolean`	no	`false`	Se on: scarta il body, restituisce solo status+headers (piu` veloce per ping/healthcheck).
`timeoutMs` Timeout (millisecondi)	`number`	no	`30000`	Default 30s. Aumenta per API lente (es. report generation).
`throwOnError` Errore su status 4xx/5xx	`boolean`	no	`true`	Se on, lo step fallisce su errore HTTP non-recuperato dal retry.

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "id": "node-action_http-1",
  "defId": "action_http",
  "label": "HTTP Request",
  "config": {
    "method": "GET",
    "url": "https://api.example.com/v1/users/{{input.id}}",
    "authMode": "none",
    "apiKeyHeaderName": "X-API-Key",
    "customAuthHeaderName": "Authorization",
    "bodyType": "json",
    "rawBinaryContentType": "application/octet-stream",
    "paginationMode": "none",
    "paginationMaxPages": 10,
    "paginationPageSize": 50,
    "paginationPageParam": "page",
    "paginationStartPage": 1,
    "paginationLimitParam": "limit",
    "paginationOffsetParam": "offset",
    "paginationStartOffset": 0,
    "paginationCursorParam": "cursor",
    "paginationCursorField": "next_cursor",
    "retryCount": 0,
    "retryInitialDelayMs": 500,
    "retryBackoffFactor": 2,
    "retryOnStatus": "429,500,502,503,504",
    "responseFormat": "auto",
    "followRedirects": true,
    "allowSelfSigned": false,
    "statusCodeOnly": false,
    "timeoutMs": 30000,
    "throwOnError": true
  }
}

HTTP Request

Description

⚙️ Configuration parameters

💡 Configuration example

🔗 Related nodes in the same category

Ready to use HTTP Request?