Generate NetSuite Authentication Tokens for Emburse Spend

Use token-based authentication (TBA) to connect Emburse Spend to your NetSuite account. TBA allows Emburse Spend to sync expense, vendor, and posting data without storing or re-entering NetSuite user credentials. NetSuite and Emburse recommend TBA because it is easier to maintain, reduces timeout and credential errors, and improves integration stability.

This article explains how to install the Emburse integration bundle, configure token-based authentication in NetSuite, and generate the four values you must enter in the Emburse Spend NetSuite integration:

  • Account ID
  • Consumer Key
  • Consumer Secret
  • Token ID and Token Secret
This article is currently only applicable to Emburse customers migrating from Emburse Nexonia to Emburse Spend. If you are a current Emburse Spend customer, see Connect NetSuite to Emburse Spend.

Prerequisites

Before you begin, ensure that:

  • Your organization uses NetSuite with the SuiteBundler and SuiteCloud capabilities enabled.
  • You have permission to install bundles and manage integrations in NetSuite. If you are not a full NetSuite administrator, coordinate with your IT or NetSuite admin.
  • You have access to a secure location (for example, a password manager or encrypted notes app) where you can temporarily store the token values you generate.

1. Install the Emburse Integration Bundle

This bundle installs the Emburse Integration role, which you will assign to your NetSuite integration user.

  1. In NetSuite, go to Customization.
  2. Select SuiteBundler > Search & Install Bundles.
    NetSuite Customization menu showing SuiteBundler then Search & Install Bundles
  3. In the Keywords field, type Emburse.
  4. In the search results, select Emburse Integration Role.
    Search results showing Emburse Integration Role with bundle ID and version
  5. Select Install and complete the installation.
    Bundle install page with Install button for Emburse Integration Role

2. Retrieve Your NetSuite Account ID

  1. In the NetSuite menu bar, go to Setup.
  2. Select Company > Company Information.
    NetSuite Setup menu open with Company > Company Information highlighted
  3. On the Company Information page, locate the Account ID field.
  4. Copy the value of Account ID and store it in your notes app.

You enter this value in the Account field in the Emburse NetSuite integration.

3. Verify or Enable Token-Based Authentication

If you do not see Access Tokens as an option, you must enable this feature in NetSuite.

  1. In the NetSuite menu bar, go to Setup.
  2. Select Company > Enable Features.
    NetSuite Setup menu open with Company > Enable Features highlighted
  3. Open the SuiteCloud tab.
  4. In Manage Authentication, select Token-based Authentication.
  5. Select Save.

4. Assign the Emburse Integration Role to a User

In NetSuite, you must grant a user the token-based authentication role.

Emburse recommends assigning token-based authentication to a dedicated integration user so deactivating a regular employee account does not break the connection.
  1. In the NetSuite menu bar, go to Setup.
  2. Select Users/Roles > Manage Users (or Employees, depending on your account).
  3. Either:
    • Select an existing user and select Edit, or
    • Create a new employee record for a user such as “Emburse Integration.”
  4. On the employee record, open the Access tab.
  5. In the Role field, select Emburse Integration.
  6. Select Add.
  7. Select Save.

This user will be associated with the TBA token you create later.

5. Create an Integration Record and Capture the Consumer Key and Consumer Secret

  1. In the NetSuite menu bar, go to Setup.
  2. Select Integration > Integration Management > Manage Integrations.
    Integration Management menu in NetSuite with Manage Integrations selected
  3. Select New.
  4. In Name, enter a clear name, such as EmburseTBA.
  5. (Optional) In Description, enter a note such as Emburse token-based authentication.
  6. Confirm that State is Enabled.
  7. Open the Authentication tab.

  8. Select Token-based Authentication.

    There are several options on the Authentication tab. If other items are selected (e.g., TBA: Authorization Flow or Authorization Code Grant), uncheck these options before clicking Save.
  9. Select Save.

NetSuite displays a confirmation page with the Consumer Key and Consumer Secret for this integration.

NetSuite Integration confirmation page showing a saved token-based authentication integration, with the Authentication tab open and the Consumer Key and Consumer Secret displayed.

NetSuite only shows the Consumer Key and Consumer Secret once on this confirmation page. If you navigate away before saving them, you must create a new integration record to generate new values.
  1. Copy the Consumer Key and Consumer Secret to your notes app or secure storage.

6. Create the TBA Token and Capture the Token ID and Token Secret

  1. In the NetSuite menu bar, go to Setup.
  2. Select Users/Roles > Access Tokens.
  3. Select New Access Token.
  4. In Application Name, select the integration you created in Step 5 (for example, EmburseTBA).
  5. In User, select the integration user you assigned the Emburse Integration role to in Step 4.
  6. In Role, select Emburse Integration.
  7. (Optional) Update Token Name if you want a more descriptive label.
  8. Select Save.

NetSuite displays a confirmation page with the Token ID and Token Secret.

  1. Copy the Token ID and Token Secret to your notes app or secure storage.
NetSuite only shows the Token ID and Token Secret on this confirmation page. If you lose these values, you must create a new access token.

7. Verify the Connection

After you have collected all four values (Consumer Key, Consumer Secret, Token ID, and Token Secret), you must enter them in Emburse Spend.

To verify the connection:

  1. Go to GearCompany Settings > Accounting Integrations and select NetSuite.
    Emburse Spend accounting integrations page showing NetSuite tile and Connect button
  2. Locate your Account ID on the Company Information page in NetSuite, and enter it in the Account ID field.
    NetSuite Configuration modal in Emburse Spend with Account Credentials fields for Account ID, Consumer Key, Consumer Secret, Token ID, and Token Secret
  3. Enter the following values in the Account Credentials section:
    • Consumer Key
    • Consumer Secret
    • Token ID
    • Token Secret
  4. Select Authenticate.

The Emburse NetSuite connector will test the connection to ensure a link has been established between the two systems. A message will be displayed upon successful connection.

Emburse Spend NetSuite Configuration modal showing Authenticate and Save and Close buttons

If the connection fails, confirm that:

  • You copied each value exactly, with no extra spaces.
  • The integration record is still Enabled in NetSuite.
  • The integration user is still active and still has the Emburse Integration role.

If issues persist, contact Emburse Spend Support and include screenshots of your NetSuite integration and access token settings.

Next steps: Configure the NetSuite connector by following the guide Configure the Emburse NetSuite Connector.

Was this article helpful?