> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# NetSuite

**Authentication:** OAuth or token-based authentication. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List open invoices over 30 days past due, by customer.
* Pull total revenue by region for Q1 and rank by largest.
* Find purchase orders pending approval longer than 5 days.

## Available Tools

#### list_accounts

List NetSuite accounts (chart of accounts) with pagination. Returns account names, numbers, and types. Use offset/lim...

#### get_account

Get a NetSuite account by internal ID. Returns full account details including name, number, type, and balance. Use li...

#### list_contacts

List NetSuite contacts with pagination. Use offset/limit for next page. Returns items array and page_info with has_ne...

#### get_contact

Get a NetSuite contact by internal ID. Returns full record details. Use list_contacts to find valid IDs. Optionally s...

#### create_contact

Create a new NetSuite contact. Use list_customers for valid company IDs. Returns the new record ID on success.

#### update_contact

Update an existing NetSuite contact. Use get_contact to check current values first. Only provided fields will be upda...

#### delete_contact

Delete a NetSuite contact by ID. This action cannot be undone. Use get_contact to verify the record first.

#### list_credit_memos

List NetSuite credit memos with pagination. Use offset/limit for next page. Use q to search. Returns items array and...

#### get_credit_memo

Get a NetSuite credit memo by internal ID. Use list_credit_memos to find valid IDs. Use expandSubResources to see lin...

#### create_credit_memo

Create a new NetSuite credit memo. Requires entity (customer ref). Use list_customers for valid IDs. Returns the new\...

#### update_credit_memo

Update an existing NetSuite credit memo. Use get_credit_memo to check current values first. Only provided fields will...

#### delete_credit_memo

Delete a NetSuite credit memo by ID. This action cannot be undone. Use get_credit_memo to verify the record first.

#### list_customers

List NetSuite customers with pagination. Use offset/limit for next page. Use q parameter to search by name. Returns i...

#### get_customer

Get a NetSuite customer by internal ID. Returns full record details. Use list_customers to find valid IDs. Optionally...

#### create_customer

Create a new NetSuite customer. Requires companyName or firstName+lastName with isPerson=true. Use list_subsidiaries...

#### update_customer

Update an existing NetSuite customer. Use get_customer to check current values first. Only provided fields will be up...

#### delete_customer

Delete a NetSuite customer by ID. This action cannot be undone. Use get_customer to verify the record first.

#### list_employees

List NetSuite employees with pagination. Use offset/limit for next page. Returns items array and page_info with has_n...

#### get_employee

Get a NetSuite employee by internal ID. Returns full record details. Use list_employees to find valid IDs. Optionally...

#### create_employee

Create a new NetSuite employee. Use list_subsidiaries and list_departments for valid reference IDs. Returns the new r...

#### update_employee

Update an existing NetSuite employee. Use get_employee to check current values first. Only provided fields will be up...

#### delete_employee

Delete a NetSuite employee by ID. This action cannot be undone. Use get_employee to verify the record first.

#### list_estimates

List NetSuite estimates/quotes with pagination. Use offset/limit for next page. Use q to search. Returns items array...

#### get_estimate

Get a NetSuite estimate by internal ID. Use list_estimates to find valid IDs. Use expandSubResources to see line item...

#### create_estimate

Create a new NetSuite estimate. Requires entity (customer ref). Use list_customers for valid IDs. Returns the new rec...

#### update_estimate

Update an existing NetSuite estimate. Use get_estimate to check current values first. Only provided fields will be up...

#### delete_estimate

Delete a NetSuite estimate by ID. This action cannot be undone. Use get_estimate to verify the record first.

#### list_invoices

List NetSuite invoices with pagination. Use offset/limit for next page. Use q to search. Returns items array and page...

#### get_invoice

Get a NetSuite invoice by internal ID. Use list_invoices to find valid IDs. Use expandSubResources to see line items....

#### create_invoice

Create a new NetSuite invoice. Requires entity (customer reference). Use list_customers for valid entity IDs. Returns...

#### update_invoice

Update an existing NetSuite invoice. Use get_invoice to check current values first. Only provided fields will be upda...

#### delete_invoice

Delete a NetSuite invoice by ID. This action cannot be undone. Use get_invoice to verify the record first.

#### list_inventory_items

List NetSuite inventory items with pagination. These are items tracked in inventory with quantity on hand. Use offset...

#### get_inventory_item

Get a NetSuite inventory item by internal ID. Returns full record details. Use list_inventory_items to find valid IDs...

#### create_inventory_item

Create a new NetSuite inventory item. Requires itemId (name). Use list_accounts for valid income, COGS, and asset acc...

#### update_inventory_item

Update an existing NetSuite inventory item. Use get_inventory_item to check current values first. Only provided field...

#### list_non_inventory_items

List NetSuite non-inventory items (items not tracked in inventory) with pagination. Use offset/limit for next page. U...

#### list_service_items

List NetSuite service items (services sold to customers) with pagination. Use offset/limit for next page. Use q to se...

#### list_journal_entries

List NetSuite journal entries with pagination. Use offset/limit for next page. Use q to search. Returns items array a...

#### get_journal_entry

Get a NetSuite journal entry by internal ID. Use list_journal_entries to find valid IDs. Use expandSubResources to se...

#### create_journal_entry

Create a new NetSuite journal entry. Include line items with debit and credit entries that balance. Use list_accounts...

#### update_journal_entry

Update an existing NetSuite journal entry. Use get_journal_entry to check current values first. Only provided fields...

#### delete_journal_entry

Delete a NetSuite journal entry by ID. This action cannot be undone. Use get_journal_entry to verify the record first.

#### list_customer_payments

List NetSuite customer payments with pagination. Use offset/limit for next page. Use q to search. Returns items array...

#### get_customer_payment

Get a NetSuite customer payment by internal ID. Use list_customer_payments to find valid IDs. Use expandSubResources...

#### create_customer_payment

Create a new NetSuite customer payment. Requires customer reference. Use list_customers for valid IDs. Returns the ne...

#### delete_customer_payment

Delete a NetSuite customer payment by ID. This action cannot be undone. Use get_customer_payment to verify the record...

#### list_purchase_orders

List NetSuite purchase orders with pagination. Use offset/limit for next page. Use q to search. Returns items array a...

#### get_purchase_order

Get a NetSuite purchase order by internal ID. Use list_purchase_orders to find valid IDs. Use expandSubResources to s...

#### create_purchase_order

Create a new NetSuite purchase order. Requires entity (vendor ref). Use list_vendors and list_inventory_items for val...

#### update_purchase_order

Update an existing NetSuite purchase order. Use get_purchase_order to check current values first. Only provided field...

#### delete_purchase_order

Delete a NetSuite purchase order by ID. This action cannot be undone. Use get_purchase_order to verify the record first.

#### run_suiteql

Execute a SuiteQL query against NetSuite. SuiteQL uses SQL-like syntax to query any record type. Example: "SELECT id,...

#### list_departments

List NetSuite departments. Use department IDs when creating transactions or records. Use offset/limit for next page.

#### list_locations

List NetSuite locations. Use location IDs when creating transactions or records. Use offset/limit for next page.

#### list_classifications

List NetSuite classifications (classes). Use class IDs when creating transactions. Use offset/limit for next page.

#### list_currencies

List NetSuite currencies. Use currency IDs when creating multi-currency transactions. Use offset/limit for next page.

#### list_sales_orders

List NetSuite sales orders with pagination. Use offset/limit for next page. Use q to search. Returns items array and...

#### get_sales_order

Get a NetSuite sales order by internal ID. Use list_sales_orders to find valid IDs. Use expandSubResources to see lin...

#### create_sales_order

Create a new NetSuite sales order. Requires entity (customer ref). Use list_customers and list_inventory_items for va...

#### update_sales_order

Update an existing NetSuite sales order. Use get_sales_order to check current values first. Only provided fields will...

#### delete_sales_order

Delete a NetSuite sales order by ID. This action cannot be undone. Use get_sales_order to verify the record first.

#### list_subsidiaries

List NetSuite subsidiaries. Required for creating records in multi-subsidiary accounts. Use offset/limit for next pag...

#### get_subsidiary

Get a NetSuite subsidiary by internal ID. Returns full subsidiary details. Use list_subsidiaries to find valid IDs.

#### list_vendor_bills

List NetSuite vendor bills with pagination. Use offset/limit for next page. Use q to search. Returns items array and...

#### get_vendor_bill

Get a NetSuite vendor bill by internal ID. Use list_vendor_bills to find valid IDs. Use expandSubResources to see lin...

#### create_vendor_bill

Create a new NetSuite vendor bill. Requires entity (vendor ref). Use list_vendors for valid IDs. Returns the new reco...

#### update_vendor_bill

Update an existing NetSuite vendor bill. Use get_vendor_bill to check current values first. Only provided fields will...

#### delete_vendor_bill

Delete a NetSuite vendor bill by ID. This action cannot be undone. Use get_vendor_bill to verify the record first.

#### list_vendors

List NetSuite vendors with pagination. Use offset/limit for next page. Returns items array and page_info with has_nex...

#### get_vendor

Get a NetSuite vendor by internal ID. Returns full record details. Use list_vendors to find valid IDs. Optionally spe...

#### create_vendor

Create a new NetSuite vendor. Use list_subsidiaries for valid subsidiary IDs. Returns the new record ID on success.

#### update_vendor

Update an existing NetSuite vendor. Use get_vendor to check current values first. Only provided fields will be updated.

#### delete_vendor

Delete a NetSuite vendor by ID. This action cannot be undone. Use get_vendor to verify the record first.