(Example) How to Get the Access Token Credentials from NetSuite (Token-Based Authentication)

To get the access token credentials from NetSuite for token-based authentication, do the procedure in this topic.

Prerequisites

  • One of these account types:
    • NetSuite Limited Edition
    • NetSuite Mid-Market Edition
    • NetSuite Enterprise Edition

Good to Know

  • AgilePoint recommends you use token-based authentication. User credentials authentication is planned for deprecation from NetSuite.
  • OAuth 2.0 access tokens require a 2-way exchange of credentials between AgilePoint NX and the external service. This means that you must get the credentials from the third-party service to paste in the AgilePoint NX access token, and get the redirect URI from AgilePoint NX to paste in the external service. This requires you to open both the AgilePoint NX access token and the third-party service at the same time, so you can copy and paste from one screen to the other.

    This topic shows the suggested procedure for NetSuite. The exact procedure for your access token depends on whether you already have a connection (usually called an app) configured in the external service.

  • This topic gives one example. The procedure may vary depending on your configuration and account settings in the third-party service.
  • Some information about third-party integrations is outside the scope of the AgilePoint NX Product Documentation, and it is the responsibility of the vendors who create and maintain these technologies to provide this information. This includes specific business uses cases and examples; explanations for third-party concepts; details about the data models and input and output data formats for third-party technologies; and various types of IDs, URL patterns, connection string formats, and other technical information that is specific to the third-party technologies. For more information, refer to Where Can I Find Information and Examples for Third-Party Integrations?

Step 1: Start Creating an Access Token in AgilePoint NX

First, create a new access token in AgilePoint NX for NetSuite.

How to Start

Procedure

  1. In AgilePoint NX, open the access token configuration screen for NetSuite.

    NetSuite Access Token screen
  2. On the NetSuite Access Token Configuration screen, in the Environment list, select your environment.

    This environment type should match the account type you used to sign in to NetSuite.

    This example uses a Production account and environment.


    NetSuite Access Token Configuration screen
  3. Select Token Based Authentication.

    NetSuite Access Token Configuration screen

    Do not configure the access token credentials.

    Keep the access token configuration screen open in AgilePoint NX, but do not save it.

Step 2: Create an Integration Record for an Application in NetSuite

Next, create an integration record for an application in NetSuite.

How to Start

  1. In a new web browser tab, sign in to NetSuite:

Procedure

  1. On the NetSuite Home screen, click Setup > Integration > Manage Integrations > New.

    NetSuite Home page
  2. On the Integration screen, in the Name field, enter an application name.

    AgilePoint recommends you use an application name associated with your AgilePoint NX app or the way you want to use the application in AgilePoint NX.


    NetSuite Integration screen
  3. In the Authentication tab, do this:
    • Deselect TBA: AUTHORIZATION FLOW
    • Deselect USER CREDENTIALS
    • Select TOKEN-BASED AUTHENTICATION (TBA)

    NetSuite Integration screen
  4. In the STATE list, select Enabled.

    NetSuite Integration screen
  5. Click Save.

    NetSuite Integration screen

    This Confirmation screen shows consumer key and consumer secret for your application.

    Note: Do not close this screen before you copy the credentials. If you close the Confirmation screen, the credentials can not be retrieved from NetSuite. If you lose these credentials, you must start this procedure again to create new values.

    NetSuite Integration screen
  6. On the Confirmation screen, in the Authentication tab, copy the CONSUMER KEY value.

    Confirmation screen
  7. In AgilePoint NX, on the NetSuite Access Token Configuration screen, in the Consumer Key field, paste the CONSUMER KEY value from NetSuite.

    NetSuite Access Token Configuration screen
  8. In NetSuite, on the Confirmation screen, in the Authentication tab, copy the CONSUMER SECRET value.

    Confirmation screen
  9. In AgilePoint NX, on the NetSuite Access Token Configuration screen, in the Consumer Secret field, paste the CONSUMER SECRET value from NetSuite.

    NetSuite Access Token Configuration screen

Step 3: Create an Access Token in NetSuite

Next, create an access token in NetSuite.

How to Start

  1. In one web browser tab, go to the NetSuite Home screen.

    For more information, refer to Create an Integration Record for an Application in NetSuite.

  2. In a different web browser tab, in AgilePoint NX, open the NetSuite access token configuration screen.

Procedure

  1. On the NetSuite Home screen, click Setup > Users/Roles > Access Tokens > New.

    NetSuite Home page
  2. On the Access Token screen, in the Application Name field, select the application name.

    In this example, select the application name created in Step 2: Create an Integration Record for an Application in NetSuite.


    Access Token screen
  3. In the User field, click List.

    Access Token screen
  4. In the Serach screen, search the user, and click the user name.

    Access Token screen

    The user name shows in the USER field.


    Access Token screen
  5. In the ROLE field, select a role for the user.

    Access Token screen
  6. Click Save.

    Access Token screen

    The Confirmation screen shows the TOKEN ID and TOKEN SECRET.

    Note: Do not close this screen before you copy the credentials. If you close the Confirmation screen, the credentials can not be retrieved from NetSuite. If you lose these credentials, you must start this procedure again to create new values.

    Access Token screen
  7. On the Confirmation screen, in the Token Id / secret section, copy the TOKEN ID value.

    Confirmation screen
  8. In AgilePoint NX, on the NetSuite Access Token Configuration screen, in the Token ID field, paste the TOKEN ID value from NetSuite.

    NetSuite Access Token Configuration screen
  9. In NetSuite, on the Confirmation screen, in the Token Id / secret section, copy the TOKEN SECRET value.

    Confirmation screen
  10. In AgilePoint NX, on the NetSuite Access Token Configuration screen, in the Token Secret field, paste the TOKEN SECRET value from NetSuite.

    NetSuite Access Token Configuration screen

Step 4: Copy the Account ID from NetSuite

Next, copy the account ID from NetSuite.

How to Start

  1. In one web browser tab, go to the NetSuite Home screen.

    For more information, refer to Create an Integration Record for an Application in NetSuite.

  2. In a different web browser tab, in AgilePoint NX, open the NetSuite access token configuration screen.

Procedure

  1. In NetSuite, on the Home screen, click Setup > Integration > SOAP Web Services Preferences.

    NetSuite Home page
  2. On the SOAP Web Services Preferences screen, in the ACCOUNT ID field, copy the ACCOUNT ID value.

    NetSuite Account ID
  3. In AgilePoint NX, on the NetSuite Access Token Configuration screen, in the Account ID field, paste the ACCOUNT ID value from NetSuite.

    Paste Account ID

Step 5: Complete the AgilePoint NX Access Token

Next, complete the AgilePoint NX access token configuration for NetSuite.

How to Start

  1. In AgilePoint NX, open the NetSuite access token configuration screen.

Procedure

  1. In AgilePoint NX, on the NetSuite Access Token Configuration screen, in the Token Name field, enter a name for the access token.

    NetSuite Access Token screen
  2. Click Test Connection.

    Test Connection

    If the connection is successful, a confirmation message shows.


    Test Connection
  3. Click Done.

    Save Access Token