netsuite

name

netsuite

description

NetSuite is a cloud-based ERP platform that helps businesses manage finance, operations, customer relationships, and eCommerce in a unified system for better efficiency and scalability. Read and write Netsuite data through One: returnauthorization, opportunity, cashsale, cashrefund, customerrefund, workorderclose and more, 1032 actions with real parameter documentation. Use whenever the user asks to look something up in Netsuite, create or update a record there, or build code against the Netsuite API.

Netsuite through One

NetSuite is a cloud-based ERP platform that helps businesses manage finance, operations, customer relationships, and eCommerce in a unified system for better efficiency and scalability.

One exposes Netsuite through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform netsuite if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Netsuite is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Netsuite account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

ReturnAuthorization

Action	Method	Path	Action id
Get a Return Authorization Record	GET	/returnAuthorization/{{id}}	conn_mod_def::GJ5Cu_vHGYw::AEBJnGV1RhGc8iUc0Ndb5A
Create a Return Authorization Record	POST	/services/rest/record/v1/returnAuthorization	conn_mod_def::GJ5CvAcGYcU::qkQ2bSQ_Tuux7ToXSfv-Fg
Remove a Return Authorization Record	DELETE	/services/rest/record/v1/returnAuthorization/{{id}}	conn_mod_def::GJ5CvOU25MA::nWbaK9JjS_WnnGI5Q8HiGg
Transform a Return Authorization to a Cash Refund	POST	/returnAuthorization/{{id}}/!transform/cashRefund	conn_mod_def::GJ5CvP6edMA::zLJ74jYuR5GFwyDLHMaYpw
Transform a Return Authorization to a Credit Memo	POST	/returnAuthorization/{{id}}/!transform/creditMemo	conn_mod_def::GJ5CvSPlAYk::yqpYk9ENRZyWp5hpmLqA9A
Transform a Return Authorization to an Item Receipt	POST	/returnAuthorization/{{id}}/!transform/itemReceipt	conn_mod_def::GJ5CvVDtsgc::f0zTZi-SRhWw_7VEzCuiYQ
Update a Return Authorization Record	PATCH	/returnAuthorization/{{id}}	conn_mod_def::GJ5CvPgEAAI::znhKBgT-TASNn-v57TCQTw
Upsert a Return Authorization Record	PUT	/returnAuthorization/{{id}}	conn_mod_def::GJ5CvE_FCrE::OP0eU300TdKHF3HFfGtOEg

Opportunity

Action	Method	Path	Action id
Get an Opportunity Record	GET	/opportunity/{{id}}	conn_mod_def::GJ5CoA_vAlA::QjcObY1CRSinCdWTfSQWhA
List Opportunity Records	GET	/services/rest/record/v1/opportunity	conn_mod_def::GJ5CnzmXMPY::ZEJ7iRMWTEmcbWN6YWmR6Q
Create an Opportunity Record	POST	/services/rest/record/v1/opportunity	conn_mod_def::GJ5CoC13REQ::I66D1ubaQyWfqZstwGPaDw
Remove an Opportunity Record	DELETE	/services/rest/record/v1/opportunity/{{id}}	conn_mod_def::GJ5CoAGWcuw::wpD1unxIQvGdWnxZLxGr5g
Transform an Opportunity to a Cash Sale	POST	/opportunity/{{id}}/!transform/cashSale	conn_mod_def::GJ5CoGEoibc::JFVSP1lXQv6Lil5ShwSVPg
Transform an Opportunity to a Sales Order	POST	/opportunity/{{id}}/!transform/salesOrder	conn_mod_def::GJ5CoTr9Qyg::_6GCxAeKQ6eRkW0a2jSwtg
Update an Opportunity Record	PATCH	/opportunity/{{id}}	conn_mod_def::GJ5CoQfuNeM::0fTZM1QpRxysL23q5THX9Q
Upsert an Opportunity Record (by External ID)	PUT	/services/rest/record/v1/opportunity/{{id}}	conn_mod_def::GJ5CoFkzRK0::NqyRLLeLRii5ynj_KKVfSQ

CashSale

Action	Method	Path	Action id
Get a Cash Sale Record	GET	/services/rest/record/v1/cashSale/{{id}}	conn_mod_def::GJ5CO7rDGRg::i-vF_zNQRvGHl436Li0yFw
Create a Cash Sale Record	POST	/services/rest/record/v1/cashSale	conn_mod_def::GJ5CO8b32MY::7WrDVsM0Szi48RJxptFRDw
Delete a Cash Sale Record	DELETE	/cashSale/{{id}}	conn_mod_def::GJ5CO7_MVNU::qn1lQUXNR3ek-cJW3viTfQ
Transform a Cash Sale into a Return Authorization	POST	/cashSale/{{id}}/!transform/returnAuthorization	conn_mod_def::GJ5CPXoKbtQ::TeB0NnGGQ5u5XVOGRkkBtQ
Transform a Customer to a Cash Sale	POST	/customer/{{id}}/!transform/cashSale	conn_mod_def::GJ5CUtCjxFk::xe_dMdrGT5m_QnGXALqjaQ
Transform a Sales Order to a Cash Sale	POST	/salesOrder/{{id}}/!transform/cashSale	conn_mod_def::GJ5CwMwWHHw::xdhEngSGQx2tbIAcuCcOWg
Update a Cash Sale Record	PATCH	/cashSale/{{id}}	conn_mod_def::GJ5CPTCxcJA::uLG6S_xCS0SjWQhlsJ278A
Upsert a Cash Sale Record	PUT	/cashSale/{{id}}	conn_mod_def::GJ5CO7-j_xM::EjOVCcUbQv6qzeF7jiVK9Q

CashRefund

Action	Method	Path	Action id
Get a Cash Refund Record	GET	/services/rest/record/v1/cashRefund/{{id}}	conn_mod_def::GJ5COhzU22w::3UKFGaAVTY2OByvkAy0IGw
List Cash Refund Records	GET	/services/rest/record/v1/cashRefund	conn_mod_def::GJ5COdtI-qQ::eq7p-vAMRrCznCqUw00Ddg
Create a Cash Refund Record	POST	/services/rest/record/v1/cashRefund	conn_mod_def::GJ5COvETVjg::KbtctwRxToqCqyEKhDTEXA
Remove a Cash Refund Record	DELETE	/cashRefund/{{id}}	conn_mod_def::GJ5COxdy-PQ::M_JjXcbnT62fky2RYLIH3Q
Transform a Cash Refund to a Credit Memo	POST	/cashRefund/{{id}}/!transform/creditMemo	conn_mod_def::GJ5COxfifo4::hMxpKij-SRK5jh82IeX2mQ
Transform a Cash Sale to a Cash Refund	POST	/cashSale/{{id}}/!transform/cashRefund	conn_mod_def::GJ5CPITFXUA::DSbAi9WdQQah9TK3iekYnQ
Update a Cash Refund Record	PATCH	/services/rest/record/v1/cashRefund/{{id}}	conn_mod_def::GJ5COwUmnII::6mJZsYKUSdOiKuLaaREAGA
Upsert a Cash Refund Record (by ID)	PUT	/cashRefund/{{id}}	conn_mod_def::GJ5COgS-WqY::IfivYVFdRCiWjeGDeW4Xkg

CustomerRefund

Action	Method	Path	Action id
Get a Customer Refund Record	GET	/services/rest/record/v1/customerRefund/{{id}}	conn_mod_def::GJ5CWGJlBqI::KbZvILjRRhCLtti7lfI3Lg
List Customer Refund Records	GET	/services/rest/record/v1/customerRefund	conn_mod_def::GJ5CWDU-FJM::3D8ZIY2yQdy6LPpe_3jgSQ
Create a Customer Refund Record	POST	/services/rest/record/v1/customerRefund	conn_mod_def::GJ5CWFo1RzQ::0z9ghP_eR-6fixn3UZ70Zw
Remove a Customer Refund Record	DELETE	/services/rest/record/v1/customerRefund/{{id}}	conn_mod_def::GJ5CWPNJ9Os::uLMBaYJUTGyJgIsxZPG7MQ
Transform a Customer Deposit to a Customer Refund	POST	/customerDeposit/{{id}}/!transform/customerRefund	conn_mod_def::GJ5CVk1rVkw::3AFO0SH3TPCK2tNiR243Fg
Transform a Customer Payment into a Customer Refund	POST	/services/rest/record/v1/customerPayment/{{id}}/!transform/customerRefund	conn_mod_def::GJ5CV6zIKzI::dbzlA-HERciNOTgYYCPkkg
Update a Customer Refund Record	PATCH	/customerRefund/{{id}}	conn_mod_def::GJ5CWRHOjkM::26ygglYfQLeAxYUVo93Amw
Upsert a Customer Refund Record (by ID)	PUT	/customerRefund/{{id}}	conn_mod_def::GJ5CWFiEKgM::zthBY5WgSpmMyqTQfkp09A

WorkOrderClose

Action	Method	Path	Action id
Get a Work Order Close Record	GET	/workOrderClose/{{id}}	conn_mod_def::GJ5C8l0VnV4::Iy_6KwvORSW1OuouSiU0Sg
List Work Order Close Records	GET	/services/rest/record/v1/workOrderClose	conn_mod_def::GJ5C8CKpp8U::tjyine6ZSyypng385NZk2Q
Insert a Work Order Close Record	POST	/services/rest/record/v1/workOrderClose	conn_mod_def::GJ5C8ocG1lA::QAwzmPTaTh-8s1qHunq79A
Remove a Work Order Close Record	DELETE	/services/rest/record/v1/workOrderClose/{{id}}	conn_mod_def::GJ5C8mS8muM::-jypXUiDQRucKOlfw4H95Q
Transform a Work Order to a Work Order Close	POST	/workOrder/{{id}}/!transform/workOrderClose	conn_mod_def::GJ5C8chgNac::EblFlJAzSbKVjLGMCic77g
Update a Work Order Close Record	PATCH	/workOrderClose/{{id}}	conn_mod_def::GJ5C8n728YQ::cPq5s8C_QTK4_q5yPTiRUQ
Upsert a Work Order Close Record	PUT	/services/rest/record/v1/workOrderClose/{{id}}	conn_mod_def::GJ5C8sloVsw::MwKaTCdsSkGOGZ8LUnql9w

AssemblyBuild

Action	Method	Path	Action id
Get an Assembly Build Record	GET	/assemblyBuild/{{id}}	conn_mod_def::GJ5CJc0vcjc::Ny5SRiZXR-m_61hlVXCZKg
List Assembly Builds (Get list of records)	GET	/assemblyBuild	conn_mod_def::GJ5CI59YZQ8::F5ECRvIOT9KeLdQwBzs1Iw
Create an Assembly Build Record	POST	/services/rest/record/v1/assemblyBuild	conn_mod_def::GJ5CJNGS7YI::XHs4iPHxTVmY-7NbDMXxjA
Remove an Assembly Build Record	DELETE	/services/rest/record/v1/assemblyBuild/{{id}}	conn_mod_def::GJ5CJHPgDoY::WS_oH67QS_WhcYRyfnKJqg
Transform an Assembly Item to an Assembly Build	POST	/assemblyItem/{{id}}/!transform/assemblyBuild	conn_mod_def::GJ5CJ_wRG6I::MyfmqmB5RaiF5vWOier9MQ
Update an Assembly Build Record	PATCH	/assemblyBuild/{{id}}	conn_mod_def::GJ5CJs5qSJQ::lExZykseQMKFMo0FSQ37Pg
Upsert an Assembly Build Record	PUT	/assemblyBuild/{{id}}	conn_mod_def::GJ5CJNFjlcA::lMi5CNLcQnCQSQiT7XJtow

AssemblyUnbuild

Action	Method	Path	Action id
Get an Assembly Unbuild Record	GET	/assemblyUnbuild/{{id}}	conn_mod_def::GJ5CKNNhRts::svvI2vNFR2iJytnvPLipcw
List Assembly Unbuild Records	GET	/assemblyUnbuild	conn_mod_def::GJ5CJ5-VFYo::06REfTWqRlu20hxSGMRQQA
Create an Assembly Unbuild Record	POST	/services/rest/record/v1/assemblyUnbuild	conn_mod_def::GJ5CKK92hao::0M16mBXIRAaMEGQlAxmHPQ
Remove an Assembly Unbuild Record	DELETE	/assemblyUnbuild/{{id}}	conn_mod_def::GJ5CKJmWz2s::qIphQANYTEi0Xm14JOrvtw
Transform an Assembly Build to an Assembly Unbuild	POST	/assemblyBuild/{{id}}/!transform/assemblyUnbuild	conn_mod_def::GJ5CJI-hJJU::6AwsUrOtQxmT8z47tR_vtg
Update an Assembly Unbuild Record	PATCH	/assemblyUnbuild/{{id}}	conn_mod_def::GJ5CKW_pC_w::MQRoIfRORDKN9Zml62uRzA
Upsert an Assembly Unbuild Record	PUT	/services/rest/record/v1/assemblyUnbuild/{{id}}	conn_mod_def::GJ5CKOKeu6o::5hezpMRPTfGN6KGzf3FyEg

ItemFulfillment

Action	Method	Path	Action id
Get an Item Fulfillment Record	GET	/itemFulfillment/{{id}}	conn_mod_def::GJ5ChFXrbLo::RzrdIpR_T-C303nBC6ICRQ
List Item Fulfillment Records	GET	/services/rest/record/v1/itemFulfillment	conn_mod_def::GJ5ChGoHMcU::i-J2tr49R0CP8dh8bRNqBw
Create an Item Fulfillment Record	POST	/services/rest/record/v1/itemFulfillment	conn_mod_def::GJ5ChSLw4ww::9w4JWk_tT6mq1XQi1o54uA
Remove an Item Fulfillment Record	DELETE	/services/rest/record/v1/itemFulfillment/{{id}}	conn_mod_def::GJ5ChPj2ZxI::UGGNTF9MQ3O01FewRg3fuw
Transform a Sales Order to an Item Fulfillment	POST	/salesOrder/{{id}}/!transform/itemFulfillment	conn_mod_def::GJ5CwZsh6iM::PLPZbmkHTM-LBgz4Yafw_A
Update an Item Fulfillment Record	PATCH	/itemFulfillment/{{id}}	conn_mod_def::GJ5ChTawBeM::e4u02fOES6Gcy8E_qr6sOw
Upsert an Item Fulfillment Record	PUT	/services/rest/record/v1/itemFulfillment/{{id}}	conn_mod_def::GJ5ChHZrPPs::sFld3CBdSQ2tyz8aOLEgDQ

Invoice

Action	Method	Path	Action id
Get an Invoice Record	GET	/services/rest/record/v1/invoice/{{id}}	conn_mod_def::GJ5CgSaIcaM::E8Z5QQ8rTTynPbM5Bh-n4g
Create (Insert) an Invoice Record	POST	/services/rest/record/v1/invoice	conn_mod_def::GJ5CgTp7WYE::K3a1gJE8Th62WraEiPMf2g
Delete an Invoice Record	DELETE	/invoice/{{id}}	conn_mod_def::GJ5CgfiJ8CI::_ZamngwvQoOWii8mNcsdpw
Transform an Invoice to a Customer Payment	POST	/invoice/{{id}}/!transform/customerPayment	conn_mod_def::GJ5CgjNRvLY::hCbFgYmqR7mfykmBTuIoyg
Transform an Invoice to a Return Authorization	POST	/invoice/{{id}}/!transform/returnAuthorization	conn_mod_def::GJ5Cgh6wKOk::NW5nhI8fTqmnvqlVO1P9Ow
Update an Invoice Record	PATCH	/invoice/{{id}}	conn_mod_def::GJ5CgiUso3w::JqBfP-CmSeGJOWSt23BQsw
Upsert an Invoice Record (Insert or Update)	PUT	/invoice/{{id}}	conn_mod_def::GJ5CgXDvNfc::-U4LY7v5SYmKgN-utMN3zg

Job

Action	Method	Path	Action id
Get a Job Record	GET	/services/rest/record/v1/job/{{id}}	conn_mod_def::GJ5CiHk5Va4::9559TVmeTX6fuWUF-vbnzQ
List Job Records	GET	/services/rest/record/v1/job	conn_mod_def::GJ5CiHY3oxs::4YHEkqmUSxyehyQVMnYeUQ
Create a Job Record	POST	/services/rest/record/v1/job	conn_mod_def::GJ5CiHijSxI::MRAZCoMITAWN_XNuocJ5yg
Remove a Job Record	DELETE	/services/rest/record/v1/job/{{id}}	conn_mod_def::GJ5CiSujnQc::Prz5sRPWQpGyZrUSwRESgA
Transform a Job to a Cash Sale	POST	/job/{{id}}/!transform/cashSale	conn_mod_def::GJ5CiVLg1r8::JMd4TtbGRBm3CebyTX3y3Q
Update a Job Record	PATCH	/services/rest/record/v1/job/{{id}}	conn_mod_def::GJ5CivEXo_U::SDASj8EzRhCgj5U5zCrHHw
Upsert a Job Record (Insert or Update)	PUT	/services/rest/record/v1/job/{{id}}	conn_mod_def::GJ5CiKYtemY::dirr-n8PQDK43mxCn01qBQ

VendorPrepaymentApplication

Action	Method	Path	Action id
Get a Vendor Prepayment Application Record	GET	/vendorPrepaymentApplication/{{id}}	conn_mod_def::GJ5C6brjRjM::--N1P3HKSP2JZU2sw_4uqw
List Vendor Prepayment Applications	GET	/services/rest/record/v1/vendorPrepaymentApplication	conn_mod_def::GJ5C6c_NxnQ::RdhvwAkdRuG-M-oJ_Rjx-g
Create a Vendor Prepayment Application Record	POST	/services/rest/record/v1/vendorPrepaymentApplication	conn_mod_def::GJ5C6pvGavQ::4fLtplcxR4WtPgK2fJ686A
Remove a Vendor Prepayment Application Record	DELETE	/vendorPrepaymentApplication/{{id}}	conn_mod_def::GJ5C6pNMUuk::wWbI-ElrTJSHp6AQS8702g
Transform a Vendor Prepayment to a Vendor Prepayment Application	POST	/vendorPrepayment/{{id}}/!transform/vendorPrepaymentApplication	conn_mod_def::GJ5C6fFM204::G_ZyPQShRkeOdIBhB8lcnQ
Update a Vendor Prepayment Application Record	PATCH	/services/rest/record/v1/vendorPrepaymentApplication/{{id}}	conn_mod_def::GJ5C6vS4DAU::gTVVLTiPQ8K6xRMBsy8AFg
Upsert a Vendor Prepayment Application Record	PUT	/vendorPrepaymentApplication/{{id}}	conn_mod_def::GJ5C6raZ6sY::X1KBsL3oSPqi-pUfE_TtRQ

VendorReturnAuthorization

Action	Method	Path	Action id
Get a Vendor Return Authorization Record	GET	/vendorReturnAuthorization/{{id}}	conn_mod_def::GJ5C65JNPW8::M8Eb5Ml1Qg6BHCo-BPOmTA

6 more VendorReturnAuthorization actions are available through search.

This lists 90 of 1032 actions. For anything not here, call search_one_platform_actions with platform netsuite. The full catalog is at https://www.withone.ai/knowledge/netsuite.

When a call fails

The error comes from Netsuite, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/netsuite

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.