NetSuite Read-Only Integration Guide

Join the Early Access Program for Kintsugi’s NetSuite Integration

Kintsugi now supports a read-only integration with NetSuite, available through our Early Access Program for select customers. This integration syncs your NetSuite transaction data into Kintsugi, supporting both Legacy Tax and SuiteTax environments.

Note: The NetSuite integration tile will not appear by default. It will only be visible to customers enrolled in the Early Access Program.

Step 1. Get Credentials from your NetSuite Account

Log in to your NetSuite Administrator account.
Get your Account ID.
1. Go to Setup > Company > Company Information.
2. On your Company Information page, scroll down until you see your Account ID
3. Copy the Account ID.
Set Up Role Permission
To grant access to the Netsuite, you need to create a user role to get Access Tokens using Token-Based Authentication
1. Go to Setup > Users/Roles > Manage Roles > New
2. Give the role a name (e.g. Kintsugi Role).
3. Under the 'Permissions' tab, select the appropriate permissions for the role. The role needs the necessary permissions to perform the integration tasks.
4. For Read-Only Integration, follow the permission setup below:
Get the Consumer Key & Consumer Secret.
1. Go to Setup > Integrations > Manage Integrations > New
2. Complete the Integration information.
  1. Name: Enter a meaningful name (for example, Kintsugi App)
  2. Authentication: Under the 'Authentication' section,
    Select 'Token-Based Authentication.'
    For TBA: Authorization flow set https://unify.apideck.com/vault/callback as callback URL.
  3. Oauth 2.0: Under the 'Oauth 2.0**' section
    Check "Authorization Code grant"
    Check "REST API services"
    Set https://unify.apideck.com/vault/callback as the redirect URL
  4. Click the 'Save' button to save the changes.
3. Once saved, the Consumer Key and Consumer Secret will be generated.
  💡 NOTE: Copy the "Consumer Key" and the "Consumer secret". You can’t access this information once you exit the screen.
Get Access Token ID & Access Token Secret
1. Go to Setup > Users/Roles > Access Tokens > New
2. Complete the form
  1. Select the "Application Name" that you have created in the previous step (e.g. Kintsugi App).
  2. Select the "User", which we created in the previous steps (e.g. Kintsugi User)
  3. Give the token a recognizable "token name" (e.g. Kintsugi Token)
  4. Click the 'Save' button to save the changes.
3. Once saved, the Access Token ID and Access Token Secret will be generated.
  💡 NOTE: Copy the "Token ID" and the "Token Secret". You can’t access this information once you exit the screen.

Step 2. Connect NetSuite to Kintsugi

Log in to your Kintsugi account.
Go to Data Sources > Browse Integrations > NetSuite > Connect
Enter NetSuite Credentials
1. Account ID
2. Consumer Key
3. Consumer Secret
4. Access Token ID
5. Access Token Secret
6. SuiteTax Enabled (Yes/No)
To learn more about SuiteTax and LegacyTax, refer to this article: Differences between SuiteTax and Legacy Tax
Click Save, then refresh your Kintsugi page. You’ll see NetSuite (Read Only) with a syncing status.

Step 3. Test the Connection

In your NetSuite account, go to Transactions > Create Invoice.
Add a sample customer and add one or more items.
Click Accept Payment to complete the invoice.
Return to Kintsugi > Transactions.
Confirm the sample invoice appears in your transactions list—showing that the sync is working correctly.