Real People, 24/7

How To Setup NetSuite Token-Based Authentication


TBA (Token Based Authentication) in your NetSuite Account is super simple to set up and use in NetSuite integrations; allocate a few minutes to get the needed credentials for your journey.

Pusateri's runs their NetSuite eCommerce business with Mailchimp using SyncApps.

See how NetSuite sales and marketing data synced automatically to your support and marketing systems can boost operational efficiencies and drive more sales. 

Let's dive in!

Are you using a NetSuite Sandbox for testing? We've got you covered; check out this article on using it.

Still, using the NetSuite integration with the username and password authentication type for NetSuite?

That's OK -- we still support it!  

However, NetSuite recommends using token-based authentication for the following benefits:

  • Can have 5 concurrent API requests
  • No password expiration issues
  • Two Factor Authentication usage
  • HMAC SHA256

So to get started using Token Based Authentication (TBA), you'll need a few things handy. You might also want to get your NetSuite administrator,  consultant, or agency involved here, as you may need their input. To set up TBA, you need:

  • Consumer Key
  • Consumer Secret
  • Token ID
  • Token Secret

Before You Use Token-Based Authentication (TBA) For Your NetSuite Integrations On SyncApps

Here's what you need before using TBA:

  1. Enable Token-Based Authentication 
  2. Create Integration record
  3. Create a Role (Accounting Center Type) and assign it to a User
  4. Create an Access Token for the Integration record, User, and Role

How To Enable NetSuite Token-Based Authentication (TBA) In SyncApps

  1. Go to your NetSuite Setup > Company > Enable Features > Suite Cloud > Manage Authentication
  2. Enable Token-Based Authentication

How to Create an Integration Record

  1. Go to menu Setup > Integrations > Manage Integrations
  2. Tap the New button
  3. Set the name to "SyncApps Integration."

Check the TOKEN-BASED AUTHENTICATION and "TBA: ISSUETOKEN ENDPOINT" options, including "User Credentials."

Next, uncheck the "TBA: AUTHORIZATION FLOW" and "AUTHORIZATION CODE GRANT" options which are checked by default when creating a new integration record.


  • If you already have an integration record for SyncApps, you can reuse it by editing the integration and checking the Token-Based Authentication option.
  • Please copy the Consumer Key and Secret values used in the Set Up configuration.

Please note that Consumer Key and Secret values are displayed only once, so please make sure you copy them before going to another page. You can also reuse the consumer key and consumer secret to link one integration to multiple access tokens.

Create a Role and Assign it to a User

  1. Go to Setup > Users/Roles > Manage Roles > New
  2. Create a role and assign necessary permissions for SyncApps integration. (Tap here for the list of permissions required for all NetSuite integrations)
  3. The role must have "User Access Tokens" permission for integration using TBA.
  4. Assign the Role to the desired user that will be used for integration. Go to Lists >Employees > Employees > Edit user > Access tab > Roles sub-tab.

Create an Access Token for the Integration Record, User, and Role

  1. Go to Setup > Users/Roles > Access Tokens > New.
  2. Select the Integration record, User, and Role created or referenced in the previous steps.
  3. Token Id and Token Secret will be displayed after tapping the save button. Copy the Consumer Key and Secret values used in the Set Up configuration.

After completing the above steps, you can now use the Consumer Key, Consumer Secret, Token ID, and Token Secret in one or multiple Set Up configurations.

Note: If you are using a NetSuite Sandbox, an example is {Account ID = XXXXXXX_sb1}, to test within Step 1 of your integration, then the steps above need to be followed inside your NetSuite Sandbox account.

Sandbox Tokens must be created and recreated if the Sandbox is refreshed.


Read the NetSuite TBA Help Center article here for a deeper insight into the robust, industry standard-based mechanism that increases overall system security. 

Need Some Help with a Human Touch?

Check out the options below on how you can contact our Support Team and find the answers you need to help you with your SyncApps integrations.

Help Center & Email is 24/7 to | Live Chat & Phone have to be scheduled.


Check out these Help Desk articles for answers to frequently asked questions.  

Get Started | Login Issues | Pricing

Have more questions? Submit a request