NetSuite documentation: Authentication
Build your own OAuth 1.0 connection with the universal HTTP connector to connect integrator.io to NetSuite SuiteTalk APIs (including SuiteQL).
- OAuth 1.0 is a three-stage workflow, where the client first gets temporary credentials, performs authorization, and exchanges the temporary credentials for permanent long-lived tokens. This connector type assumes that you have already completed these steps and obtained the long-lived token and secret before setting up an OAuth 1.0 connection using endpoints. However, in the near future, Celigo will launch an upgraded OAuth 1.0 connector with the ability to retrieve the credentials for you.
- OAuth1.0 requires signed requests with complicated signature methods. While establishing the OAuth1.0 connection, integrator.io will sign the request using the signature method that you choose below.
- A. Set up an HTTP connection
- B. Provide general HTTP connection settings
- C. Edit OAuth 1.0 settings
- D. Edit common HTTP settings
- E. Save and test the connection
Start establishing a connection in either of the following ways:
- From the Resources menu, select Connections. Then, click+ Create connection at the top right.
- 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. From the Application list, under Universal connectors, select HTTP.
- After the HTTP Application is added, click the Connection setting’s + button to proceed.
Edit the General settings specific to your account and this connection resource.
Name (required): Enter a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.
Application (required, non-editable): A reminder of the app you’re editing.
Mode (required): Select Cloud.
Edit the Application details settings specific to your base uri and media type.
Base URI (required): Enter the SuiteTalk URI. To find this, log in to you're NetSuite account and navigate to Setup > Company > Company Information > Company URLs > SuiteTalk (SOAP and REST Web Services).
Media type (required): Enter JSON.
Continuing in the Create connection panel, select OAuth 1.0 for the Auth type.
Signature method (required): Select HMAC-SHA256.
Consumer key (required): Enter the consumer key.
Consumer secret (required): Enter the consumer secret.
Access token (required): Enter the required token ID.
Token secret (required): Enter the value retrieved with your Token ID, above. Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s Token ID and Secret safe. When editing this form later, you must enter this value again; it is stored only for a saved connection.
Realm (required): Enter your NetSuite ID as the realm value. To find this, log in to you're NetSuite account and navigate to Company > Integration > SOAP web services preferences > Primary information.
HTTP method (optional): Select GET.
Relative URI (optional): Enter this endpoint that will always work: /services/rest/record/v1/metadata-catalog/customer.
Once you have configured the HTTP 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 panel
- Close – 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.
If the connection fails, double-check the provided settings, and test again.