Skip to main content

​
Prerequisite: Setting up Token-Based Authentication in NetSuite

Definite uses Token-Based Authentication (TBA) to securely connect to your NetSuite account. You’ll need to gather the following credentials from NetSuite:
  • Account ID
  • Consumer Key and Consumer Secret
  • Token ID and Token Secret

​
Step 1: Enable Token-Based Authentication

1
Log into your NetSuite account as an Administrator.
2
Navigate to Setup > Company > Enable Features.
3
Click the SuiteCloud tab.
4
Under Manage Authentication, check the box for Token-Based Authentication.
5
Click Save.

​
Step 2: Find your Account ID

1
Navigate to Setup > Company > Company Information.
2
Find your Account ID in the information displayed.
If you’re using a Sandbox account, the Account ID will have a _SB suffix (e.g., 1234567_SB).
3
Copy and save your Account ID somewhere you can refer to later.

​
Step 3: Create an Integration Record

1
Navigate to Setup > Integration > Manage Integrations > New.
2
Enter a name for the integration (e.g., “Definite Integration”).
3
Under Authentication, ensure Token-Based Authentication is checked.
4
Uncheck TBA: Authorization Flow and Authorization Code Grant if they are checked.
5
Click Save.
6
After saving, NetSuite will display your Consumer Key and Consumer Secret.
Copy these values immediately and store them securely. The Consumer Secret will not be shown again.

​
Step 4: Create an Access Token

1
Navigate to Setup > Users/Roles > Access Tokens > New.
2
Select the Application Name (the integration you created in Step 3).
3
Select a User that has the appropriate permissions to access the data you want to sync.
4
Select a Role for the token. The role should have sufficient permissions to read the records you want to extract.
5
Enter a Token Name (e.g., “Definite Token”).
6
Click Save.
7
After saving, NetSuite will display your Token ID and Token Secret.
Copy these values immediately and store them securely. The Token Secret will not be shown again.

​
Add to Definite

1
Go to this link to add an integration. Search for NetSuite and click it to get to the creation form.
2
Add a name for your integration.
3
Enter the credentials you gathered from the steps above:
FieldDescription
Account IDYour NetSuite Account ID (include _SB suffix for sandbox)
Token KeyThe Token ID from Step 4
Token SecretThe Token Secret from Step 4
Consumer KeyThe Consumer Key from Step 3
Consumer SecretThe Consumer Secret from Step 3
4
Click Save. Definite should automatically take you back to the integrations page where you can see your new NetSuite integration.

​
Troubleshooting

​
Invalid Login Attempt

If you receive an “Invalid Login Attempt” error, verify:
  • Your Account ID is correct (check for _SB suffix if using sandbox)
  • Token-Based Authentication is enabled in NetSuite
  • The user associated with the token has the correct role and permissions
  • All credential values were copied correctly without extra spaces

​
Permission Errors

Ensure the role assigned to your access token has the necessary permissions:
  • Lists > Records permission for the record types you want to sync
  • Reports permission if syncing report data
  • SuiteAnalytics Connect permission for full data access