Company-Wide Preferences

In some cases, you may want to set company-wide preferences that affect all SOAP web services calls made to your NetSuite account. Changes to these preferences are propagated to every user.

You can set these preferences at Setup > Integration > SOAP Web Services Preferences.

Some of these preferences can be overridden when you send individual SOAP web services requests. For details, see One-Time Preferences. Be aware also that additional preferences are available at the request level.


The SOAP Web Services Preferences page also includes information whether the web services and RESTlet concurrency governance is enabled for your account, and about the available concurrency limit for your account. For information about web services and RESTlet concurrency governance, see Web Services and RESTlet Concurrency Governance

The following preferences can be set on a company-wide basis:

Disable Mandatory Custom Field Validation

This preference affects the handling of custom fields that are configured in the UI to be mandatory. If you set this preference to true, the fields are not treated as required during SOAP web services requests. If the preference is set to false, the fields are required. In these cases, if you fail to provide the required value, the system returns a USER_ERROR, with instructions to provide a value for the field.

When deciding whether to enable this preference, consider whether the data being provided comes from a system that has equivalent fields to the custom field.

This preference can be overridden at the request level. For details, see disableMandatoryCustomFieldValidation.

Run Server SuiteScript and Trigger Workflows

This preference setting is applied to the entire company. However, you can overwrite this preference in each SOAP web services request. For details, see Request-Level Preferences.

This preference enables server SuiteScripts and triggers workflows and is selected by default. If this preference is not selected, all SuiteScript scripts and workflows are disabled.

If you disable this option, you do both of the following:

If you are bringing historical data into NetSuite, consider disabling this option to increase speed of operations and block executions of additional logic performed automatically by executed scripts and workflows. If you are syncing live data or running a partner application (for example, Outlook Sync) you should use the default option, Server. In other words, you should consider enabling server SuiteScript to ensure that your business logic runs for your integrated application. However, note that doing so may have a negative performance impact.


To ensure that your business logic is fully executed, always use the default option, Server. Additionally, changing the default option can potentially break your working integration. You are discouraged from doing so unless you are an advanced SOAP web services user.

Require Approval During Auto-Installation of Integration

Auto-installation is the automatic creation of an integration record in your NetSuite account. For example, in some cases, a partner may provide you with an updated version of an application. This update may include a new application ID created by using an integration record. The first time you send a request using this application, a new integration record is created in your account.

The Require Approval during Auto-Installation of Integration preference affects whether this new record is automatically enabled. If the preference is set to false, the State field on the new application is automatically set to Enabled, and all requests are permitted. If the preference is set to true, the State field on the new integration record is set to Waiting for Approval. In the latter case, you must manually edit the record and set the State to Enabled. Until you do, all requests sent by that application are blocked.

Search Page Size

The Search Page Size preference determines the number of records returned in the results of a search. This preference affects both synchronous and asynchronous searches. When you set this preference on a company-wide basis, valid values are between 5 and 1,000. The default value is 1,000.

This preference can be overridden at the individual search level. When setting this preference for a particular search, note that the maximum for an asynchronous search is greater than the maximum that can be set at the company-wide level. For more details, see pageSize.

Treat Warnings as Errors

When this preference is enabled, warning messages generated by NetSuite are treated as errors that cause an exception, resulting in rejection of the request. For more information on the difference between errors and warnings, see SOAP Web Services Warnings, Errors, and Faults.

This preference can be overridden at the request level. For details, see warningAsError.

Related Topics

SuiteTalk SOAP Web Services Platform Overview
SOAP Web Services Preferences
One-Time Preferences
Setting the Internal ID Preference
Caching Behavior in SOAP Web Services

General Notices