# Connect NetSuite to Starshipit
URL: https://support.starshipit.com/articles/213384326-connect-netsuite-to-starshipit
Canonical: https://support.starshipit.com/articles/213384326-connect-netsuite-to-starshipit
Markdown: https://support.starshipit.com/articles/213384326-connect-netsuite-to-starshipit.md
Updated: 2026-09-03

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Integrate your NetSuite platform with Starshipit to import orders and write back tracking information when you print labels.

Integrate your NetSuite platform with Starshipit to import orders and write back tracking information when you print labels. You can configure Starshipit to import Item Fulfilments, Sales Orders or Invoices.

## Before you begin

You need a NetSuite administrator who can create a token-based authentication role, integration record, and access token.

## Prepare NetSuite access

1. Go to **Setup > Company > Enable Features > SuiteCloud**. Enable **Client SuiteScript**, **Server SuiteScript**, and **Token-Based Authentication**, then save.
2. Go to **Setup > Users/Roles > Manage Roles > New**. Name the role `Starshipit Integration Role`, select **Web Services Only Role**, then add the permissions below at **Full** level.

| Permission group | Permissions |
| --- | --- |
| Transactions | Find Transactions, Fulfill Orders, Item Fulfillment, Sales Order |
| Lists | Items, Currency |
| Setup | User Access Tokens, SOAP Web Services |

3. Assign **Starshipit Integration Role** to the NetSuite user that will own the connection.

## Create the integration and token

1. Go to **Setup > Integration > Manage Integrations > New** and name it `Starshipit TBA`.
2. Enable **User Credentials** and **Token-Based Authentication**. Disable **Authorization Code Grant** and **TBA: Authorization Flow**, then save.
3. Copy the **Consumer Key** and **Consumer Secret** from the integration record.
4. Go to **Setup > Users/Roles > Access Tokens > New**. Select `Starshipit TBA`, the assigned user, and **Starshipit Integration Role**, then save.
5. Copy the **Token ID** and **Token Secret** from the confirmation page.
6. Go to **Setup > Integration > Web Services Preferences** and copy the **Account ID**.

## Connect NetSuite in Starshipit

1. Go to **Settings > Integrations > Add a new integration > NetSuite** and turn on **Enable NetSuite**.
2. Select **Token-Based** authentication.
3. Enter the account ID exactly as NetSuite provides it, then enter the consumer key, consumer secret, token ID, token secret, role ID, and application ID.
4. If you have multiple subsidiaries or locations, use the **Advanced** tab to limit the records this connection uses.
5. Turn on **Sync Fulfilments** when Starshipit should synchronise NetSuite fulfilment records.
6. Click **Save**, then **Test to ensure it works**.

Use **Use Sandbox** only when you are connecting to a NetSuite sandbox rather than production.

## Import Custom Fields

The following information can be imported from NetSuite to Starshipit when the values are stored in custom fields with designated script ids:

* **Delivery Instructions** - custbody_delivery_instructions (Text Custom Field)
* **Authority To Leave** - custbody_authority_to_leave (Boolean Custom Field)
* **Signature Required** - custbody_signature_required (Boolean Custom Field)

## Troubleshooting

The NetSuite API limits each NetSuite user to a single API connection based on the user's login credentials. This can cause Starshipit that use a NetSuite connection to fail with the following errors if other calls are made to the NetSuite API using the same credentials:

* Only one request may be made against a session at a time
* The operation has timed out

If the error occurred while updating your NetSuite orders, then Starshipit will try to update these orders again in a scheduled fashion to ensure the orders are being updated in NetSuite.

Alternatively, you can purchase concurrent connection licenses from NetSuite which will permit simultaneous requests from the same user account.

For temporary testing purposes, you can point Starshipit to your NetSuite sandbox environment by appending the sandbox Id to your Web Service Account Id, e.g. '1234567_SB1' (this has '_SB1' appended).