Set up a basic auth connection to NetSuite

Netsuite documentation: Authentication

Caution: With the release of API version 2021.1, NetSuite does not allow new accounts to connect to a RESTlet via basic authentication. This auth type is now marked “To be deprecated – do not use.” If you’re still using basic authentication, you’ll need to change your authentication method to a more secure method.

Two additional NetSuite authentication types are available: token-based (automatic) and token-based (manual). However, if you are installing an integration app or adding a connection to one, you must establish your connection to NetSuite according the integration app’s instructions. For example, see Install Salesforce - NetSuite (IO).

A. Set up a NetSuite connection

Start establishing a connection to NetSuite in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select NetSuite.

The Create connection pane opens with required and advanced settings.

B. Describe your NetSuite connection

First, name your connection in the General settings:

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing. 

C. Supply required NetSuite account information

At this point, you’re presented with options for providing NetSuite authentication.

Authentication type (required): Select Basic.

Email (required): Enter the registered email address of the NetSuite account.

Password (required): Provide the password that you created on account setup. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this value again; it is stored only for a saved connection.

D. Edit advanced NetSuite settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the NetSuite connection.

Link SuiteScript integrator (optional): This setting appears only when you edit a NetSuite connection. Prior to integrator.io, NetSuite integrations built by Celigo ran directly inside your NetSuite account via a managed bundle. If you are still running any of these older integrations, check this box to link integrator.io to your NetSuite account. 

Borrow concurrency from (optional): Select another connection from the list....

Concurrency level (optional): Up to 25 allowed....

WSDL version: New Web Services Description Language (WSDL) versions are available when creating or editing a NetSuite connection. A WSDL is simply an XML document describing the latest versions of a web service. By choosing a WSDL you are choosing to upgrade to a new or older version of NetSuite’s web services.

Version 2018.1 is the only version that supports a basic auth connection (not recommended). The other current and future versions will not support a basic auth connection. Versions 2020.2; 2023.1; and later support both manual and automatic token-based auth connections.

Switching versions for an existing connection might have an impact on running flows, and we recommend reviewing NetSuite’s release notes prior to making a change. We recommend using the latest WSDL version.

E. Save and test the connection

Once you have configured the NetSuite connection, you have a few options for continuing:

• Save – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account
• Save & close – click to test and save the connection and exit the Create connection pane
• Cancel – click to exit without saving any new changes
• Test connection – click this button to verify that your new connection is free of errors

When you test or save the connection, it is verified before continuing. 

The new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.