> 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.md).

# NetSuite

NetSuite ERP integration for managing business operations, accounting, and customer data.

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector        | Authentication |
| ---------------- | -------------- |
| NetSuite (TBA)   | Credentials    |
| NetSuite (OAuth) | OAuth sign-in  |

#### NetSuite (TBA)

Connect to NetSuite using Token-Based Authentication (TBA) to interact with your ERP system.

**Set up in NetSuite**

1. In NetSuite, go to **Setup → Company → Enable Features → SuiteCloud** and enable **Token-Based Authentication** under Manage Authentication.
2. Go to **Setup → Integration → Manage Integrations → New**, create an integration record with Token-Based Authentication enabled, and copy the **Consumer Key** and **Consumer Secret** (shown only once).
3. Go to **Setup → Users/Roles → Access Tokens → New**, choose the integration application, the user, and a role with REST/RESTlet permissions, then copy the **Token ID** and **Token Secret** (shown only once).

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **NetSuite (TBA)**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field   | Required | What to enter                                                                                   |
| --------------- | -------- | ----------------------------------------------------------------------------------------------- |
| Account ID      | Yes      | Your NetSuite Account ID (e.g., 1234567 or 1234567\_SB1 for sandbox).                           |
| Consumer Key    | Yes      | Consumer Key from your NetSuite integration record (Setup > Integration > Manage Integrations). |
| Consumer Secret | Yes      | Consumer Secret from your NetSuite integration record.                                          |
| Token ID        | Yes      | Token ID from NetSuite (Setup > Users/Roles > Access Tokens).                                   |
| Token Secret    | Yes      | Token Secret from NetSuite access token.                                                        |

**Provider documentation:** [Setup reference](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_161942084079.html).

#### NetSuite (OAuth)

Connect to NetSuite using OAuth 2.0 to interact with your ERP system.

**Set up in NetSuite**

1. In NetSuite, go to **Setup → Company → Enable Features → SuiteCloud** and enable the OAuth 2.0 / REST Web Services features.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **NetSuite (OAuth)**.
2. Complete the connector configuration below. If you do not have access to these settings, ask your StackAI administrator to configure the connector.
3. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
4. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connector configuration**

| StackAI field | Required  | What to enter                                                                                                                       |
| ------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| OAuth Scopes  | Read-only | OAuth scopes for NetSuite API access. This value is shown for reference; it is not an editable credential.                          |
| Client ID     | Yes       | OAuth 2.0 Client ID from NetSuite.                                                                                                  |
| Client Secret | Yes       | OAuth 2.0 Client Secret from NetSuite.                                                                                              |
| Redirect URI  | Read-only | Use this redirect URI when configuring your OAuth application. This value is shown for reference; it is not an editable credential. |
| Account ID    | Yes       | Your NetSuite Account ID. [Provider instructions](https://developer.netsuite.com/app/help/helpcenter.nl?search=account+id).         |

**Provider documentation:** [Setup reference](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_157780312610.html).

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

#### Detailed setup guides

* [Connect NetSuite](https://docs.stackai.com/integrations/catalog/netsuite/connect-netsuite.md)

## Use an action

1. Add the required **NetSuite** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

| Action                                | Purpose                                                                | Required inputs                               |
| ------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------- |
| Create Account                        | Create a new account in NetSuite                                       | Account Name                                  |
| Delete Account                        | Delete an account from NetSuite                                        | Account ID                                    |
| Get Account                           | Retrieve account information from NetSuite                             | Account ID                                    |
| List Accounts                         | List accounts from NetSuite                                            | None listed                                   |
| Create Accounting Period              | Create a new accounting period in NetSuite                             | Period Name, Start Date, End Date             |
| Delete Accounting Period              | Delete an accounting period from NetSuite                              | Period ID                                     |
| Get Accounting Period                 | Get a specific accounting period from NetSuite                         | Period ID                                     |
| List Accounting Periods               | List accounting periods from NetSuite                                  | None listed                                   |
| Create Assembly Build                 | Create a new assembly build in NetSuite                                | Item ID, Quantity                             |
| Delete Assembly Build                 | Delete an assembly build from NetSuite                                 | Build ID                                      |
| Get Assembly Build                    | Get a specific assembly build from NetSuite                            | Build ID                                      |
| List Assembly Builds                  | List assembly builds from NetSuite                                     | None listed                                   |
| Update Assembly Build                 | Update an existing assembly build in NetSuite                          | Build ID                                      |
| Create Assembly Item                  | Create a new assembly item in NetSuite                                 | Item ID, Display Name                         |
| Delete Assembly Item                  | Delete an assembly item from NetSuite                                  | Item ID                                       |
| Get Assembly Item                     | Get a specific assembly item from NetSuite                             | Item ID                                       |
| List Assembly Items                   | List assembly items from NetSuite                                      | None listed                                   |
| Transform Assembly Item to Build      | Transform an assembly item to assembly build in NetSuite               | Assembly Item ID, Build Quantity              |
| Transform Assembly Item to Work Order | Transform an assembly item to work order in NetSuite                   | Assembly Item ID, Work Order Quantity         |
| Transform Assembly to Unbuild         | Transform an assembly build to assembly unbuild in NetSuite            | Assembly Build ID                             |
| Update Assembly Item                  | Update an existing assembly item in NetSuite                           | Item ID                                       |
| Create Billing Account                | Create a new billing account in NetSuite                               | Account Name, Customer ID                     |
| Delete Billing Account                | Delete a billing account from NetSuite                                 | Account ID                                    |
| Get Billing Account                   | Get a specific billing account from NetSuite                           | Account ID                                    |
| List Billing Accounts                 | List billing accounts from NetSuite                                    | None listed                                   |
| Update Billing Account                | Update an existing billing account in NetSuite                         | Account ID                                    |
| Upsert Billing Account                | Insert or update a billing account in NetSuite                         | External ID, Account Name, Customer ID        |
| Create Billing Schedule               | Create a new billing schedule in NetSuite                              | Schedule Name, Frequency                      |
| Delete Billing Schedule               | Delete a billing schedule from NetSuite                                | Schedule ID                                   |
| Get Billing Schedule                  | Get a specific billing schedule from NetSuite                          | Schedule ID                                   |
| List Billing Schedules                | List billing schedules from NetSuite                                   | None listed                                   |
| Update Billing Schedule               | Update an existing billing schedule in NetSuite                        | Schedule ID                                   |
| Upsert Billing Schedule               | Insert or update a billing schedule in NetSuite                        | External ID, Schedule Name, Frequency         |
| Create Bin Transfer                   | Create a new bin transfer in NetSuite                                  | Bin Transfer Data                             |
| Delete Bin Transfer                   | Delete a bin transfer from NetSuite                                    | Bin Transfer ID                               |
| Get Bin Transfer                      | Get detailed information about a specific bin transfer from NetSuite   | Bin Transfer ID                               |
| List Bin Transfers                    | List bin transfers from NetSuite with pagination and search support    | None listed                                   |
| Update Bin Transfer                   | Update an existing bin transfer in NetSuite                            | Bin Transfer ID, Bin Transfer Update Data     |
| Upsert Bin Transfer                   | Insert or update a bin transfer in NetSuite using external ID          | External ID, Bin Transfer Data                |
| Create Calendar Event                 | Create a new calendar event in NetSuite                                | Calendar Event Data                           |
| Delete Calendar Event                 | Delete a calendar event from NetSuite                                  | Calendar Event ID                             |
| Get Calendar Event                    | Get detailed information about a specific calendar event from NetSuite | Calendar Event ID                             |
| List Calendar Events                  | List calendar events from NetSuite with pagination and search support  | None listed                                   |
| Update Calendar Event                 | Update an existing calendar event in NetSuite                          | Calendar Event ID, Calendar Event Update Data |
| Upsert Calendar Event                 | Insert or update a calendar event in NetSuite using external ID        | External ID, Calendar Event Data              |
| Create Intercompany Journal Entry     | Create a new advanced intercompany journal entry in NetSuite           | Subsidiary ID, Transaction Date               |
| Delete Intercompany Journal Entry     | Delete an advanced intercompany journal entry from NetSuite            | Entry ID                                      |
| Get Intercompany Journal Entry        | Get a specific advanced intercompany journal entry from NetSuite       | Entry ID                                      |
| List Intercompany Journal Entries     | List advanced intercompany journal entries from NetSuite               | None listed                                   |
| Update Intercompany Journal Entry     | Update an advanced intercompany journal entry in NetSuite              | Entry ID                                      |
| Create Project                        | Create a new project in NetSuite                                       | Project Name, Customer ID                     |
| Delete Project                        | Delete a project from NetSuite by ID                                   | Project ID                                    |
| Get Project                           | Retrieve a project from NetSuite by ID                                 | Project ID                                    |
| List Projects                         | List and search projects in NetSuite                                   | None listed                                   |
| Update Project                        | Update an existing project in NetSuite                                 | Project ID                                    |
| Create Purchase Order                 | Create a new purchase order in NetSuite                                | Vendor, Items                                 |
| Get Purchase Order                    | Get a specific purchase order from NetSuite                            | Purchase Order ID                             |
| List Purchase Orders                  | List purchase orders from NetSuite                                     | None listed                                   |
| Update Purchase Order                 | Update an existing purchase order in NetSuite                          | Purchase Order ID                             |
| Custom SuiteQL                        | Use this tool to write custom queries to fetch data from NetSuite.     | SuiteQL Query                                 |
| Search Records                        | Search NetSuite vendors, items, locations, employees and more          | Record Type                                   |

### Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# 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.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.
