Registry / crm / n8n-nodes-netsuite-rest

n8n-nodes-netsuite-rest

library0.1.12jsnpmunverified

A community node for n8n that integrates with NetSuite's SuiteTalk REST API, enabling automation of 150+ standard record types (Customers, InventoryItems, SalesOrders) plus custom records, custom fields (custentity_*, custbody_*), and SuiteQL queries. Version 0.1.12 requires Node >=20.15 and peer dependency n8n-workflow. Key differentiators: automatic extraction of new record IDs from NetSuite responses, built-in debug mode for request/response inspection, and support for nested collections. Only installable by n8n instance owners via Settings > Community Nodes. Common use cases: CRM and ERP automation, order management, inventory synchronization.

crm ecommerce

npm install n8n-nodes-netsuite-rest

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · N8N-NODES-NETSUITE

n8n-nodes-netsuite-rest

crmjavascriptv0.1.12

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

NetSuiteRest

✓ import { NetSuiteRest } from 'n8n-nodes-netsuite-rest'

✗ const NetSuiteRest = require('n8n-nodes-netsuite-rest')

ESM-only export; requires Node >=20.15 and n8n >= community node installation flow

INetSuiteRestCredentials

✓ import type { INetSuiteRestCredentials } from 'n8n-nodes-netsuite-rest'

TypeScript users must use import type for interface definitions to avoid runtime side effects

default import

✓ import NetSuiteRestNode from 'n8n-nodes-netsuite-rest'

✗ import { default as NetSuiteRest } from 'n8n-nodes-netsuite-rest'

Default export is the node class; named export NetSuiteRest also exists

N8nNodeDescription

✓ import { NetSuiteRest } from 'n8n-nodes-netsuite-rest'; const description: INodeTypeDescription = NetSuiteRest.description;

Node description is attached as static property on the class

Shows how to import, instantiate, and execute the NetSuite REST node programmatically with a SuiteQL query using token-based authentication from environment variables.

import { NetSuiteRest } from 'n8n-nodes-netsuite-rest'; import { Workflow } from 'n8n-workflow'; // Register the node with n8n execution environment const node = new NetSuiteRest(); console.log('Node type:', node.description.name); // 'netSuiteRest' // Configure credentials (typically done in n8n UI) const credentials = { accountId: process.env.NETSUITE_ACCOUNT_ID ?? '', consumerKey: process.env.NETSUITE_CONSUMER_KEY ?? '', consumerSecret: process.env.NETSUITE_CONSUMER_SECRET ?? '', tokenId: process.env.NETSUITE_TOKEN_ID ?? '', tokenSecret: process.env.NETSUITE_TOKEN_SECRET ?? '', }; // Execute a SuiteQL query (example workflow) const executionData = { node: node.description, data: {}, credentials: { netSuiteRestApi: credentials }, runExecutionData: { startNode: 'Start', resultData: { runData: {}, lastNodeExecuted: null, }, executionData: { contextData: {}, nodeExecutionStack: [{ node: { name: 'NetSuite REST', type: node.description.name, parameters: { resource: 'query', operation: 'execute', query: "SELECT id, companyName FROM customer WHERE email IS NOT NULL" } } }], }, }, }; // Trigger execution const result = await node.execute(executionData); console.log(result);

Debug

Known issues

breakingRequires Node >=20.15; older versions cause installation failure.

fix

Update Node to >=20.15. Check with `node --version`.

affects: <20.15

gotchaOnly n8n instance owners can install community nodes. Non-owners cannot install via UI.

fix

Ensure you are logged in as the instance owner in n8n settings.

affects: *

gotchaNetSuite REST API requires OAuth 1.0 credentials. Token-based authentication must be configured in NetSuite Integration Record first.

fix

Create an Integration Application in NetSuite (Setup > Integration > Manage Integrations > New) and assign token-based auth roles.

affects: *

deprecatedOAuth 1.0 is being phased out by NetSuite; future versions may require OAuth 2.0.

fix

Monitor NetSuite documentation for OAuth 2.0 migration timelines. No immediate action needed.

affects: >=0.1.0

gotchaCustom fields prefix must match regex custentity_* or custbody_*. Custom record types require proper naming conventions.

fix

Verify custom field names in NetSuite UI match expected prefixes. Use 'custentity_myfield' not 'myfield'.

affects: *

breakingPeer dependency n8n-workflow must be installed; otherwise node fails silently at runtime.

fix

Ensure n8n-workflow is listed in your package.json dependencies or installed globally. n8n community node installer handles this automatically.

affects: *

Errors

Common errors & fixes

Cannot find module 'n8n-workflow'

Peer dependency n8n-workflow not installed.

fix

Run `npm install n8n-nodes-netsuite-rest n8n-workflow` or reinstall via n8n UI.

Error: Unsupported node engine. The package requires Node >=20.15

Node.js version is too old.

fix

Upgrade Node.js to version 20.15 or higher. Use `nvm install 20.15` if using nvm.

401 Unauthorized - NetSuite REST API

OAuth 1.0 credentials are invalid or missing required permissions.

fix

Verify account ID, consumer key/secret, token ID/secret. Ensure integration record in NetSuite has appropriate roles and is active.

TypeError: Cannot read properties of undefined (reading 'execute')

Node not properly registered or constructor called without required metadata.

fix

Use the node instance obtained from n8n's node loader or instantiate with `new NetSuiteRest()`. Do not use static methods without instance.

Upgrade

Version history

0.1.12latest on npm

Audit

Dependencies

n8n-workflowrequiredPeer dependency required for n8n node registration and execution context

Agent activity

39 hits · last 30 days

node

Resources

githubhttps://github.com/entech-code/n8n-nodes-netsuite-rest ↗

packagen8n-nodes-netsuite-rest ↗

homepagehttps://github.com/entech-code/n8n-nodes-netsuite-rest#readme ↗