Overview
This node performs an HTTP POST request to a specified URL with customizable query parameters, JSON body, and additional headers. It is useful for integrating with APIs that require sending data via POST, such as submitting forms, triggering webhooks, or exporting data to external services.
Use Case Examples
- Sending data to a REST API endpoint with specific query parameters and headers.
- Exporting entity data to an external system by posting JSON payloads.
Properties
| Name | Meaning |
|---|---|
| URL | The endpoint URL to which the POST request is sent. |
| Query Parameters | Key-value pairs appended to the URL as query parameters for the request. |
| JSON Body | The JSON payload sent in the body of the POST request. |
| Additional Headers | Custom HTTP headers included in the request. |
Output
JSON
statusCode- HTTP status code returned by the API.headers- HTTP response headers from the API.body- Parsed JSON response body from the API.
Dependencies
- Requires network access to the target URL.
Troubleshooting
- Invalid JSON Body error occurs if the JSON Body input is not valid JSON. Ensure the JSON is correctly formatted.
- HTTP request failures may occur due to incorrect URL, network issues, or server errors. Verify the URL and network connectivity.
- If query parameters or headers are not set correctly, the API may reject the request or respond unexpectedly. Double-check parameter names and values.