Real People, 24/7

How to Setup NetSuite Token-Based Authentication as Authentication Type in SyncApps Integrations

How does token-based authentication (TBA) work with the SyncApps NetSuite integrations?

TBA (Token Based Authentication) in your NetSuite Account is super simple to get set up and use in your SyncApps integrations. 

Using a NetSuite Sandbox for testing? We've got you covered.

Well, good news! SyncApps supports NetSuite Token Based Authentication (TBA) as an Authentication Type.

It should be super simple to get this set up today for any NetSuite integration you are using with SyncApps.

If you are still using the NetSuite integration Authentication Type for NetSuite Username and Password then don't worry as we support it, however, NetSuite recommends using TBA as it has the following benefits.

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

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 it gets into the NetSuite weeds.

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


And to use Token Based Authentication (TBA), the following things need to be done first:

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


Enable Token Based Authentication (TBA)

See how to enable Token Based Authentication (TBA) easily below:

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


Create an Integration Record

See how to create an Integration Record below:


  1. Go to menu Setup > Integrations > Manage Integrations
  2. Tap the New button
  3. Set the name to "SyncApps Integration". Please make sure to tick the Token-Based Authentication option, uncheck the "TBA: AUTHORIZATION FLOW" and "AUTHORIZATION CODE GRANT" option, and check the "TBA: ISSUETOKEN ENDPOINT"  option with User Credentials too.


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


Please take note that Consumer Key and Consumer 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 (consumer key and consumer secret) to multiple access tokens.


Create a Role and assign it to a User

See how to create a Role and assign it to a User below:

  1. Go to Setup > Users/Roles > Manage Roles > New
  2. Create a role and assign necessary permissions for SyncApps integration. (Please 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.



  1. 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

See below how to 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.


  1. Token Id and Token Secret will be displayed after tapping the save button. Please copy the Consumer Key and Consumer secret values to be used in the Set Up configuration.



After the above steps are completed, 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 need to be created and recreated again 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?


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 is scheduled.


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

Get Started | Login Issues | Pricing

Check out our subscriber's story here on how SyncApps helped them save hundreds of hours per year!



Have more questions? Submit a request