HTTP Request
The HTTP Request node is your universal connector. It allows you to interface with absolutely any API on the web. Fetch data from external databases, post form submissions to CRMs, or download binary files by configuring custom headers, query parameters, and complex JSON bodies.
What can you do with HTTP Request?
Full Protocol Support
Supports all standard HTTP methods including GET, POST, PUT, PATCH, DELETE. Manage custom request headers, strict timeouts, OAuth tokens, and session cookies seamlessly.
Dynamic Authentication
Integrate natively with nLink's credential vault to securely inject API keys, Bearer tokens, or Basic Auth details without ever exposing them in plaintext configurations.
Flexible Data Handling
Send nested JSON, multipart/form-data, or URL-encoded strings. The node automatically intercepts and parses incoming JSON responses into cleanly formatted output arrays.
Advanced Fault Tolerance
Automatically swallow 404/500 API errors and route them dynamically to a dedicated Error Port using the 'Continue On Fail' property to prevent catastrophic pipeline crashes.
Detailed Usage & Configuration
The HTTP Request node is the bridge between your internal nLink workflow and the external web. Use it to ping webhooks, download data from external SaaS endpoints, or trigger remote server scripts.
1. Building Your Request
You have granular control over exactly how your network request is dispatched:
- Method & URL: Define standard verbs (
GET, POST, PUT, DELETE, PATCH) and dynamically map the URL target via variables. - Headers & Query Parameters: Inject static standard headers like
Content-Typeor pass complex URL query strings dynamically from previous workflow steps. - Request Body: Send raw JSON payloads, simple URL-encoded form data, or even construct heavily complex
multipart/form-datapayloads complete with binary file uploads directly from the local disk.
2. Authentication Vault Integration
Never hardcode API keys. The HTTP node integrates natively with nLink's secure Credential Vault.
Simply map your node to an existing Basic Auth, Header Auth, OAuth2, or JWT credential type. When the node executes, nLink automatically intercepts the request natively in the backend, injects the highly secure tokens into the headers or query strings, and dispatches it safely.
3. Resiliency & Retries
Network calls fail frequently. The node includes a built-in Auto-Retry engine. If an external API returns a 500 Server Error or a 429 Rate Limit, the node will autonomously pause and re-attempt the request utilizing exponential backoff (e.g., retrying 3 times, waiting 1000ms between attempts) before definitively failing the pipeline.
continueOnFail in the node config, the node unlocks a specialized Error Port on the canvas. Instead of completely crashing the workflow upon receiving a fatal HTTP 404/500, the execution flow is smoothly diverted into the Error Port, allowing you to trigger fallback alerts (like Slack or Email) flawlessly without breaking the overall system architecture.
