Generic HTTP
AI-generatedOverview
This node provides a generic interface to interact with the NetSuite API using Token-Based Authentication (OAuth 1.0a HMAC-SHA256). It supports multiple operations including generic HTTP requests, CRUD operations on records, listing records, and executing SuiteQL queries. This flexibility allows users to perform a wide range of NetSuite API interactions within n8n workflows, such as retrieving metadata, managing customer records, or running custom queries.
Use Case Examples
- Perform a GET request to retrieve metadata catalog from NetSuite SuiteTalk REST API.
- Create or update a customer record using the Records (CRUD) operation.
- List customer records with pagination using the Records (List) operation.
- Execute a SuiteQL query to fetch specific data from NetSuite.
Properties
| Name | Meaning |
|---|---|
| Domain | Specifies the NetSuite domain or API type to target, such as SuiteTalk REST, RESTlet, or a Custom domain. |
| Custom Base URL | The base URL to use for API requests when the domain is set to Custom. |
| Method | HTTP method to use for the generic HTTP request (GET, POST, PUT, PATCH, DELETE). |
| Path | The API endpoint path to call, relative to the base URL. |
| Script ID | Internal script ID for RESTlet domain. |
| Deploy ID | Deployment number for RESTlet domain. |
| Send Body | Whether to send a JSON body with the request. |
| JSON Body | The JSON payload to send in the request body if Send Body is true. |
| Return Full Response | Whether to return the full HTTP response including headers and status. |
| Add Prefer: transient Header | Whether to add the 'Prefer: transient' header to the request, which can affect how NetSuite processes the request. |
Output
JSON
json- The JSON response data from the NetSuite API call.
Dependencies
- NetSuite TBA credentials (Token-Based Authentication)
Troubleshooting
- Common issues include authentication failures due to incorrect or missing credentials. Ensure the NetSuite TBA credentials are correctly configured.
- Incorrect API paths or methods can cause errors; verify the domain, path, and HTTP method are appropriate for the intended NetSuite API endpoint.
- If sending a request body, ensure the JSON body is correctly formatted and matches the expected schema for the API endpoint.
- Errors from NetSuite API are returned in the response; enabling 'Return Full Response' can help debug by providing headers and status codes.
Links
- NetSuite API Documentation - Official documentation for NetSuite APIs including SuiteTalk REST, RESTlets, and SuiteQL.