> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/netsuite/connect-netsuite.md).

# Connect NetSuite

## Connecting NetSuite to StackAI (Token-Based Authentication)

This guide walks through setting up a **NetSuite Token-Based Authentication (TBA)** connection so StackAI can read and/or write data in your NetSuite account.

Note: Our most popular NetSuite action is **Custom SuiteQL**, shown below:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F6zWrrhNKnEwyMs5d26ZP%2FScreenshot%202026-07-08%20at%205.28.02%E2%80%AFPM.png?alt=media)

By the end of this guide you'll have collected **five values** to paste into StackAI to establish the connection:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FqzxiBYoHwzdU7a8jk0zL%2FScreenshot%202026-07-08%20at%204.15.34%E2%80%AFPM.png?alt=media)

### Step 1: Enable the required features

Go to Setup -> Company -> Enable Features:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F40upwL39mmLVTPheWEfW%2FScreenshot%202026-07-08%20at%204.17.56%E2%80%AFPM.png?alt=media)

Make sure you have SuiteAnalytics Workbook, Token-Based Authentication, and REST Web Services all enabled for your account:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FDttUPjWp5pfUvVC3KV0f%2FScreenshot%202026-07-08%20at%204.20.35%E2%80%AFPM.png?alt=media)

### Step 2: Find your Account ID

Go to Setup -> Company -> Company Information:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FyyeAPdab4S2Vl2ZFotzO%2FScreenshot%202026-07-08%20at%204.21.49%E2%80%AFPM.png?alt=media)

Jot down your Account ID shown here:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FhrRnvpOhIyQTjE179qzu%2FScreenshot%202026-07-08%20at%204.22.33%E2%80%AFPM.png?alt=media)

### Step 3: Register StackAI as an Integration Record

Go to Set up -> Integration -> Manage Integrations -> New

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2Fq5l7thYqW1Z66ipK1f6j%2FScreenshot%202026-07-08%20at%204.26.19%E2%80%AFPM.png?alt=media)

Give it a name, and check "TOKEN-BASED AUTHENTICATION". Uncheck anything in the OAuth 2.0 section - this integration used TBA only.

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FZKgxcJ8nrRyvK2HZ4cAG%2FScreenshot%202026-07-08%20at%204.27.13%E2%80%AFPM.png?alt=media)

Hit Save -> Then jot down the consumer key and consumer secret (it is only shown once):

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FRT1Lea9rzvfCDWm5Lrc6%2FIntegration%20Record.png?alt=media)

### Step 4: Create a role with the right permissions

Go to Setup -> Users/Roles -> Manage Roles -> New

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FIu6nECILCuJPH1R1mPFD%2FScreenshot%202026-07-08%20at%204.31.30%E2%80%AFPM.png?alt=media)

Create a new role:

* Enter a name
* Select "All" for Accessible subsidaries
* Select "WEB SERVICES ONLY ROLE" in the Authentication section. (You can put anything for center type since this is a web services only role)

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2Fhdyjh95A9cxt01SQEmtp%2FScreenshot%202026-07-08%20at%204.34.52%E2%80%AFPM.png?alt=media)

Set the following permissions for the integration to work:

* SuiteAnalytics Workbook (Reports sub-tab)
* Log in using Access Tokens (Setup sub-tab)
* REST Web Services (Setup sub-tab)

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F5zmHhz7f6wyLn7aJDtog%2FScreenshot%202026-07-08%20at%204.46.06%E2%80%AFPM.png?alt=media)

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F2bJcFCTmoxRURDvaTehL%2FScreenshot%202026-07-08%20at%204.46.23%E2%80%AFPM.png?alt=media)

### Step 5: Assign the role to a user

Go to Lists -> Employees -> Employees -> Search

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FxgmYSzxUwwuU5xcztKsb%2FScreenshot%202026-07-08%20at%204.49.37%E2%80%AFPM.png?alt=media)

Search for the user you want to assign the role to:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FcgydzioRr2j2Q8jv8tvX%2FScreenshot%202026-07-08%20at%204.50.49%E2%80%AFPM.png?alt=media)

Click Edit:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FsbscHI970lovdTi5kU7t%2FScreenshot%202026-07-08%20at%204.51.34%E2%80%AFPM.png?alt=media)

* Check "Give Access"
* Add the role you created in Step 4
* Hit Save

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F0G29Qdx2OEPW7GAlDOyc%2FScreenshot%202026-07-08%20at%204.54.07%E2%80%AFPM.png?alt=media)

Important Note! You need to make sure the user who is logged into netsuite UI has "Access Token Management" permission for the next step. This can be assigned to the user as a global permission, or it can be added to the administrator role and the user could be assigned the administrator role in the screenshot above.

### Step 6: Generate an Access Token

Go to Setup -> Users/Roles -> Access Tokens -> New

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FdSGlKOuGjrMdfQj6BznF%2FScreenshot%202026-07-08%20at%204.57.26%E2%80%AFPM.png?alt=media)

Fill in the Application name from Step 3, User from Step 5, and Role from Step 4. Choose a name for the token and hit Save.

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2F2kijJM5Kgf0F9nVMxgtB%2FScreenshot%202026-07-08%20at%204.58.13%E2%80%AFPM.png?alt=media)

Jot down the Token ID and Token Secret (they are only shown once)

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FXsJSgyu7RyM3Gv5LBzf7%2FScreenshot%202026-07-08%20at%204.59.32%E2%80%AFPM.png?alt=media)

### Step 7: Create the connection in StackAI

Enter all fields collected in the StackAI UI:

![Connect NetSuite setup](https://1957915746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FpseoPYLWd8rr41J69V7N%2FScreenshot%202026-07-08%20at%205.01.29%E2%80%AFPM.png?alt=media)

## Connection fields and action reference

See [NetSuite](https://docs.stackai.com/integrations/catalog/netsuite.md) for the current connector fields and supported actions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/netsuite/connect-netsuite.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
