Back to Integrations
Action

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.

HTTP Request
Network / Action
⚠️

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-Type or 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-data payloads 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.

⚡ Error Port Routing (Continue On Fail): If you toggle 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.