HTTP Request
The HTTP Request node (makeHttpRequest) sends a request using a reusable
HTTP Request Connection config
node.
Request Properties
Section titled “Request Properties”| Property | Purpose |
|---|---|
| Name | Flow label. |
| Connection | Base URL, authentication, and default headers. |
| Path | Path appended to the connection Base URL. |
| Method | GET, POST, PUT, PATCH, or DELETE. |
| Payload | Ignore, send as body, or append as query parameters. |
| Return | Parse as object, return string, or return binary Buffer. |
msg.path overrides the configured Path. msg.payload supplies the body or
query values according to the Payload setting.
The current runtime uses the method configured on the node. Configure separate nodes when a flow needs different HTTP verbs.
Payload Modes
Section titled “Payload Modes”- Ignore: do not send
msg.payload. - Body: objects are JSON encoded; strings are sent directly.
- Query: object keys are appended as URL query parameters.
Return Modes
Section titled “Return Modes”- Object: parse JSON and fall back to text.
- String: return raw response text.
- Binary: return a Buffer.
The parsed result replaces msg.payload.
Errors And Response Handling
Section titled “Errors And Response Handling”Network failures and response bodies containing an error field are reported
through node.error. Attach a Catch node and validate the returned payload
before using it.
Do not place secrets in normal headers when a credential field is available, and do not expose unrestricted URLs through agent-controlled parameters.