Overview
This node performs HTTP POST requests to a specified URL with customizable query parameters, headers, and a JSON body. It is useful for scenarios where you need to send data to an API endpoint or web service, such as submitting form data, triggering webhooks, or interacting with RESTful APIs.
Use Case Examples
- Sending data to a REST API endpoint with specific query parameters and headers.
- Triggering a webhook with a JSON payload.
- Posting form data to a server with custom headers.
Properties
| Name | Meaning |
|---|---|
| URL | The target URL to which the HTTP POST request is sent. |
| Query Parameters | Key-value pairs appended to the URL as query parameters for the HTTP request. |
| Headers | Key-value pairs sent as HTTP headers with the request. |
| JSON Body | The JSON-formatted body content sent with the POST request. |
Output
JSON
statusCode- HTTP status code of the response, always 200 in this implementation.headers- Headers of the HTTP response, currently an empty object.body- The parsed JSON response body returned from the HTTP request.
Dependencies
- Requires an HTTP request helper available in the n8n environment to perform the POST request.
Troubleshooting
- Invalid JSON Body error occurs if the JSON Body input is not valid JSON. Ensure the JSON Body is correctly formatted.
- HTTP request failures due to incorrect URL, network issues, or server errors. Verify the URL and network connectivity.
- Empty or missing query parameters or headers may cause unexpected API behavior; ensure all required parameters and headers are provided.