Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To run a NetSuite saved search from MuleSoft, use the SOAP-based NetSuite Connector’s Search operation to execute a search request. Use Get Saved Search when you need to discover existing saved-search IDs for a record type; it returns IDs, not the saved search’s result rows. This distinction determines which operation belongs in your flow.

What each MuleSoft operation does

MuleSoft’s NetSuite Connector integrates through SuiteTalk Web Services and its SOAP API. The connector exposes separate operations for finding saved-search IDs and executing searches.

Operation Use it for Input Output
Get Saved Search Discover saved searches available for a record type Required Search Type A list of existing saved-search IDs for that record type; the connector reference describes the output as binary with NetSuite SOAP attributes
Search Execute a search against a record type A search request, including the applicable search style and criteria Search results, with paging support

These operation descriptions are from the MuleSoft NetSuite Connector 12.0 Reference. Do not treat the ID-discovery operation as a way to fetch saved-search rows.

Check compatibility before building the flow

MuleSoft’s release notes list NetSuite Connector 12.0.2, released September 21, 2026. Its compatibility table specifies Mule 4.9.0 or later, OpenJDK 17, and SuiteTalk API versions 2020.2, 2021.1, 2023.1, and 2025.2. MuleSoft notes that a NetSuite product version and a SuiteTalk API version are not the same thing, so check the connector release notes and the API configured for your project rather than inferring compatibility from the NetSuite product version alone. See the NetSuite Connector release notes for the versioned compatibility details.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The 12.0 reference says you can select a WSDL version. If you do not select one, the connector uses SuiteTalk 2020_2. When selecting a WSDL version, follow the reference’s namespace guidance: remove the SuiteTalk version from namespaces in the Mule application. If relying on the default, do not modify existing namespaces. Verify the selected connector, WSDL, and API combination in your project before copying configuration examples.

Add the connector and configure the connection

  1. Add the module: In Anypoint Studio, open Exchange from the Mule project’s module search and add the NetSuite Connector. Follow the MuleSoft Studio setup guide for the current Studio workflow.
  2. Find the account ID: In NetSuite, go to Setup > Integration > Web Service Preferences to find the account ID used for SuiteTalk Web Services, as described in MuleSoft’s setup guide.
  3. Enter connection details: Configure the connector’s connection information for the target NetSuite account and the authentication method supported by your project. The exact credentials and settings depend on the account and connector configuration.
  4. Test the connection: Use the guide’s Test Connection step before building or running the search flow. Resolve connection errors before diagnosing search criteria or result mapping.

Choose the operation for the task

Use Get Saved Search to discover IDs

Choose Get Saved Search when the flow needs to retrieve existing saved-search IDs for a particular search type. Its required parameter is Search Type. Because its documented output is binary with NetSuite SOAP attributes, inspect the actual payload in the target project and transform it deliberately; do not assume the result already matches a particular Mule object schema.

Use Search to execute a search request

Choose Search when the flow needs to retrieve records matching a request. MuleSoft documents Basic, Advanced, and Join search styles, along with paging. The operation’s documented defaults and options include:

  • Page size: The default is 10. This is an operation default, not a promise that a search will return every matching record in one response.
  • Limit: Values at or below zero mean no limit, according to the connector reference. Configure limits in the context of the integration’s volume and runtime needs.
  • Body fields only: This option can improve performance by excluding associated-list or sublist fields. Enable it only if the flow does not need those fields.
  • Return Search Columns: This option defaults to true. Confirm that the returned columns fit the fields your downstream mapping expects.

These settings do not guarantee that the account’s saved-search definition, access permissions, criteria, or output columns will produce the rows and fields a particular integration needs. Those details must be checked against the actual search and account.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Validate rows, paging, and mapped output

MuleSoft’s release history records a fix for a historical issue in which saved-search results could omit records when a page size was set in NetSuite Search preferences. That note documents a fixed issue in a particular release history; it does not establish that the current release has the same defect. Still, validate completeness in the target environment rather than assuming a configured page size or a successful response represents all matching rows.

  • Run the search against representative data and compare returned counts with an independent expected count.
  • Exercise more than one page where the result set warrants it, and verify that the flow continues through the available pages.
  • Repeat validation after changing page size or the saved-search preferences that may affect paging.
  • Inspect the connector payload and confirm that field selection, SOAP attributes, and any transformation preserve the values required downstream.

The connector reference also lists Async Search for use cases that warrant queued processing. MuleSoft describes asynchronous requests as queued jobs that return a job ID, which can be checked for status and results; the reference says job IDs are valid for 30 days. Consider it when workload volume or runtime requirements call for asynchronous execution, not as a substitute for validating the regular search flow.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Do not confuse the MuleSoft connector with Oracle’s export SuiteApp

Oracle’s NetSuite Connector Saved Search Export is a separate SuiteApp workflow for exporting saved-search data as structured files and sending them by SFTP. Each saved-search record used is a feed. Oracle’s documentation lists the SuiteApp and a NetSuite Connector account as prerequisites, and requires the CUSTOMRECORDS and SERVERSIDESCRIPTING features. It is not the MuleSoft Get Saved Search operation, nor is it a drop-in replacement for a SuiteTalk integration flow.

MuleSoft also documents a separate NetSuite REST Connector for REST Record Web Services and SuiteQL, with REST Web Services and OAuth 2.0 prerequisites that include an integration record and JWT signing certificate/private key. That is a different connector and authentication context; the operations discussed here belong to the SOAP/SuiteTalk NetSuite Connector. See the MuleSoft NetSuite REST Connector documentation for that separate integration path.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.