Overview
This node provides a flexible interface to interact with NetSuite's REST API by allowing users to send raw HTTP requests. It supports multiple request types such as Record, SuiteQL, Workbook, and Dataset, enabling advanced users to perform custom operations beyond predefined actions.
Common scenarios where this node is beneficial include:
- Executing custom SuiteQL queries to retrieve complex data sets.
- Accessing or manipulating specific records in NetSuite using custom paths and methods.
- Integrating with NetSuite features not yet supported by standard nodes.
- Sending arbitrary REST requests for testing or advanced workflows.
For example, a user can perform a GET request to fetch sales orders, or a POST request to insert new records by specifying the exact API path and payload.
Properties
| Name | Meaning |
|---|---|
| Request Type | The category of the request to send. Options: Record, SuiteQL, Workbook, Dataset. |
| HTTP Method | The HTTP method to use for the request. Options: DELETE, GET, HEAD, OPTIONS, PATCH, POST, PUT. |
| Path | The API endpoint path relative to the NetSuite REST base URL (e.g., services/rest/record/v1/salesOrder). |
| Body | The raw string content to send as the request body (for methods like POST, PATCH). |
| Options | Additional options: |
| Concurrency | Maximum number of concurrent REST requests sent at the same time (default is 1). |
| Full Response | If enabled, returns the full HTTP response including status code and headers instead of just the body. |
Output
The output JSON structure depends on the response from the NetSuite REST API:
- By default, the node outputs the parsed JSON body of the HTTP response.
- If the "Full Response" option is enabled, the output includes an object with:
statusCode: HTTP status code of the response.headers: HTTP response headers.body: Parsed JSON body of the response.
The node does not explicitly handle binary data output.
Dependencies
- Requires valid NetSuite API credentials configured in n8n to authenticate requests.
- Uses the
@fye/netsuite-rest-apipackage internally to make REST calls. - Supports concurrency control via the
p-limitpackage to manage parallel requests.
Troubleshooting
- Invalid Credentials or Authentication Errors: Ensure that the API key or token credentials are correctly set up and have sufficient permissions.
- Incorrect API Path or Method: Verify the correctness of the
PathandHTTP Methodproperties. Using unsupported endpoints or methods may cause errors. - Malformed Request Body: When sending a body payload, ensure it is valid JSON or matches the expected format for the API endpoint.
- Rate Limiting or Concurrency Issues: If you encounter rate limiting errors, try reducing the concurrency setting.
- Unsupported Operation Error: If an operation other than those listed is specified, the node throws an error unless "Continue On Fail" is enabled.