Change your NetSuite connection to token-based authentication

You can change your integration app's NetSuite connection from basic authentication to token-based authentication (TBA), either manual or automatic. Token-based authentication is more secure and is the recommended way to connect to NetSuite. First enable TBA and create a custom role in NetSuite, then update the connection using the manual or automatic method.

Step 1: Enable token-based authentication in NetSuite

1. Sign in to NetSuite as an administrator.
2. Go to Setup > Company > Enable Features.
3. On the SuiteCloud subtab, under Manage Authentication, select TOKEN-BASED AUTHENTICATION.
4. Select Save.

Step 2: Create a custom role for the integration app

Create your role by customizing (cloning) a locked Celigo role. Celigo eTail SmartConnectors and Celigo integrator.io Full Access w/o 2FA[Locked] are locked custom roles; when you clone one, you can add permissions to fit your requirements. These roles are available in Celigo integrator.io bundle 1.7.4.14 (bundle ID 20038) and later. Use only alphanumeric characters in custom role names.

1. In NetSuite, go to Setup > Users/Roles > Manage Roles.
2. Next to the role for your integration app, select Customize.
3. Enter a new name for the role, and save it.

Switch to token-based authentication (manual)

Assign the role to the NetSuite user

1. Sign in to NetSuite as an administrator.
2. Go to Setup > Users/Roles > Manage Users.
3. Select the user who will use token-based authentication, and then select Edit.
4. On the employee page, go to Access > Roles, enter your custom role, and select OK.
5. Select Save.

Create an access token in NetSuite

1. Go to Setup > Users/Roles > Access Tokens, and select New Access Token.
2. In Application Name, select eTail Connectors (Token-Based Auth) for eCommerce apps or High Tech Connector (Token-Based Auth) for high-tech apps.
3. In User, enter the employee name.
4. In Role, select your custom role.
5. Select Save. NetSuite generates the token ID and token secret.

Important: The token ID and token secret are displayed only once. Save them somewhere secure, such as a password manager, so you can reference them later.

Update the integration app connection

A NetSuite administrator with the required roles or permissions can update the connection.

1. Sign in to integrator.io and open the integration app.
2. Go to Connections.
3. Next to the NetSuite connection, select Actions, and then select Edit Connection.
4. In Authentication Type, select Token Based Auth (Manual).
5. Enter the Token ID and Token Secret you saved. See Establish connections in integrator.io.
6. Select the appropriate iClient. Without it, you get an invalid or missing consumerKey error.
7. Select Test connection. When the connection works, you see the message "Your connection is working great! Nice Job."
8. Select Save & close.

Switch to token-based authentication (automatic)

1. In NetSuite, assign the custom role to the NetSuite user.
2. Sign in to integrator.io and open the integration app.
3. Go to Connections.
4. Next to the NetSuite connection, select Actions, and then select Edit Connection.
5. In Authentication Type, select Token Based Auth (Automatic).
6. Select the appropriate iClient. Without it, you get an invalid or missing consumerKey error.
7. Select Save & authorize. The NetSuite sign-in page opens.
8. Enter your NetSuite credentials to authorize the connection.

Product-specific guides

For product-specific instructions, see the guide for your integration app:

• integrator.io
• eCommerce: Amazon - NetSuite, BigCommerce - NetSuite, eBay - NetSuite, Magento 1 - NetSuite, Magento 2 - NetSuite, Shopify - NetSuite, Square - NetSuite, and Walmart - NetSuite
• High-tech: ADP - NetSuite, Cash Application Manager, Jira - NetSuite, Salesforce - NetSuite, Vendor Payment Manager, and Zendesk - NetSuite

Related articles

• NetSuite connection prerequisites
• Prepare your NetSuite account for the integrator.io bundle
• Add multiple connections to your integration app