Skip to main content
A NetSuite Administrator role is required to complete this setup — it involves enabling account features, editing role permissions, and creating an integration record.

​
Sign in to NetSuite

Sign in to NetSuite as an administrator before starting — enabling features, editing role permissions, and creating the integration record all require administrator access.

1

Sign in to NetSuite

Open the NetSuite login page and sign in.

  • Enter your Email address and Password, then click Log In.
  • Sign in to the same account (production or sandbox) that you want to connect.
NetSuite Log In screen with Email address and Password fields

​
Enable required features and permissions

Before creating the integration, make sure the account has the SuiteTalk REST API features enabled and that the connecting role can authenticate with OAuth 2.0.

1

Enable REST Web Services

In the top navigation bar, go to Setup > Company > Enable Features and open the SuiteCloud subtab. Under SuiteTalk (Web Services), check REST WEB SERVICES.

Enable Features SuiteCloud subtab, SuiteTalk (Web Services) section with REST Web Services checked
2

Enable OAuth 2.0

Still on the SuiteCloud subtab, scroll to Manage Authentication and check OAUTH 2.0. Click Save when done.

Enable Features SuiteCloud subtab, Manage Authentication section with OAuth 2.0 checked
3

Grant the role permissions

In the top navigation bar, go to Setup > Users/Roles > Manage Roles, then click Edit next to the role the connecting user will use. On the role page, open the Permissions subtab — it is split into sub-tabs by permission type (Transactions, Reports, Lists, Setup, etc.). Add the permissions below on the matching sub-tab, then click Save.

  • On the Setup sub-tab, add REST Web Services with Level set to Full.
  • On the Setup sub-tab, add Log in using OAuth 2.0 Access Tokens with Level set to Full.
  • Add record-level permissions (Level Full) for the data StackOne will access. A recommended baseline: Customers, Vendors, Employees, Invoice, Bills, Sales Order, Purchase Order, Journal Entry, Credit Memo, Customer Payment, Deposit, Items, Accounts, Subsidiaries, Departments, Currency — plus SuiteScript if you also enabled RESTlets.
Role Permissions subtab with the Setup sub-tab selected, showing REST Web Services and Log in using OAuth 2.0 Access Tokens set to Level Full

​
Create an integration record

Register StackOne as an OAuth 2.0 integration application in NetSuite.

1

Open Manage Integrations

Go to Setup > Integration > Manage Integrations to open the Integrations list, then click New.

Integrations list with the New button highlighted
2

Enter a name for the integration

In the NAME field, enter a name to identify the integration (for example, StackOne Integration). Leave STATE set to Enabled.

  • Leave REFRESH TOKEN VALIDITY (IN HOURS) at its default of 168 (7 days). This is the standard NetSuite refresh-token lifetime and is suitable for StackOne — StackOne refreshes the token automatically before it expires. Setting it lower forces more frequent reconnection.

​
Configure OAuth 2.0

In the Authentication subtab, enable OAuth 2.0 with the Authorization Code Grant and register the StackOne redirect URI.

1

Enable Authorization Code Grant and set the Redirect URI

In the OAuth 2.0 section, check AUTHORIZATION CODE GRANT. In the REDIRECT URI field, enter the StackOne callback URL exactly.

  • Redirect URI: https://api.stackone.com/connect/oauth2/netsuite/callback
  • Leave PUBLIC CLIENT unchecked.
Integration form showing Authorization Code Grant, Redirect URI, and the REST Web Services scope
2

Select the REST WEB SERVICES scope

Enables actions: Create Account, Create Credit Memo, Create Customer, Create Customer Payment, Create Deposit, Create Employee, Create Expense Report, Create Inventory Item, Create Invoice, Create Journal Entry, Create Non-Inventory Sale Item, Create Purchase Order, Create Sales Order, Create Service Sale Item, Create Vendor, Create Vendor Bill, Create Vendor Payment, Delete Customer, Delete Invoice, Delete Journal Entry, Delete Purchase Order, Delete Sales Order, Delete Vendor, Delete Vendor Bill, Execute SuiteQL Query, Get Account, Get Credit Memo, Get Currency, Get Customer, Get Customer Payment, Get Department, Get Deposit, Get Employee, Get Expense Report, Get Inventory Item, Get Invoice, Get Journal Entry, Get Location, Get Purchase Order, Get Sales Order, Get Subsidiary, Get Unified Credentials, Get Unified Organization, Get Unified Role, Get Unified User, Get Vendor, Get Vendor Bill, Get Vendor Payment, List Accounts, List Credit Memos, List Currencies, List Customer Payments, List Customers, List Departments, List Deposits, List Employees, List Expense Reports, List Inventory Items, List Invoices, List Journal Entries, List Locations, List Non-Inventory Sale Items, List Purchase Orders, List Sales Orders, List Service Sale Items, List Subsidiaries, List Unified Organizations, List Unified Roles, List Unified Users, List Vendor Bills, List Vendor Payments, List Vendors, Update Account, Update Customer, Update Invoice, Update Journal Entry, Update Purchase Order, Update Sales Order, Update Vendor, Update Vendor Bill

Under SCOPE, enable REST WEB SERVICES so the integration can access the SuiteTalk REST API.

​
Save and copy the credentials

Save the integration record and copy the generated client credentials into StackOne.

1

Save the integration

Click Save. NetSuite creates the integration and displays the Client Credentials on the confirmation page.

2

Copy the Client ID and Client Secret

Copy the CONSUMER KEY / CLIENT ID value into the Client ID field, and the CONSUMER SECRET / CLIENT SECRET value into the Client Secret field, in the StackOne Connector profile.

  • These values are displayed only once. After you leave this page they cannot be retrieved — if lost, reset the credentials to generate new values.
  • Scopes (optional): leave as the default rest_webservices unless you also enabled RESTlets, in which case enter rest_webservices restlets.
Client Credentials section showing the Consumer Key / Client ID and Consumer Secret / Client Secret with values redacted

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for NetSuite:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select NetSuite
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for NetSuite.