Skip to content

NetSuite

NetSuite uses REST web services for integration. The Base URL is https://{account-id}.suitetalk.api.netsuite.com.

See the NetSuite REST documentation and REST API Browser for full details.

Setup Guide

You'll need the following information to set up your NetSuite App with Iconnek SYNC:

InputNotesExample
Account IDRetrieved from your NetSuite base URL0000000
Consumer KeyFrom the integration you create
Certificate IDFrom the OAuth 2.0 setup you configure

Preparing the connection

Enable features

To use NetSuite REST web services, the relevant features must be enabled and the user must have required permissions.

  1. Navigate to Setup > Company > Enable Features then select the SuiteCloud tab.
  2. Enable the Rest Web Services checkbox options under SuiteTalk (Web Services).
  3. Click Save.

Add a New Integration

  1. In your NetSuite account, navigate to Setup > Integration > Manage Integrations > New.
  2. Add a Name, a Description, and set State to Enabled.
  3. Uncheck everything in Token-based Authentication. If not possible:
    • In OAuth 2.0: Check Client credentials.
    • In Token-based Authentication: Uncheck all fields.
  4. In OAuth 2.0 section under Scope, check all available fields (RESTLETS, REST WEB SERVICES, SUITEANALYTICS CONNECT).
  5. Check Client Credentials (Machine to Machine grant).
  6. Save the integration.
  7. Copy the Client ID (Consumer ID) and Client Secret (Consumer Secret).

Generate an RSA Key

  1. In your SYNC account, generate an RSA certificate and copy the public key.
  2. Create a .pem file with the copied public key.

Upload Public Key to NetSuite

  1. Navigate to Setup > Integration > Manage Authentication.
  2. Go to OAuth 2.0 Client Credentials (M2M) Setup > New.
  3. Configure the following:
    • Entity: Select a user with Log in using OAuth 2.0 Access Tokens permission.
    • Role: Select a role with Log in using OAuth 2.0 Access Tokens permission.
    • Application: Select your integration (e.g., iconnek).
  4. Select the public key as the Certificate.
  5. Save and copy the Certificate ID.