Custom Tool Script Enhancements in NetSuite 2026.1

TL;DR Opening

Starting in NetSuite 2026.1, enhancements to custom tool scripts have been introduced, which include improved logging capabilities and a new Custom Tools page for better management. These changes are designed to support external AI integrations and improve the user experience for developers and administrators.

What's New

In the 2026.1 release, two main updates were introduced for custom tool scripts:

Custom Tool Script and SDF Object Updates

The custom tool script type and its related SuiteCloud Development Framework (SDF) object received critical updates to enhance logging capabilities. You can now view execution logs for custom tool scripts via the Script Execution Logs page found under Customization > Scripting > Script Execution Logs. This feature provides better monitoring and troubleshooting capabilities.

To implement logging support, make sure existing and new custom tool scripts include the following updates:

• Add the JSDoc tag @NScriptType CustomTool.
• Declare entry point functions for tool methods as asynchronous.

For the associated SDF object XML definition files:

• Change the SDF object name from tool to toolset.
• Update the script ID prefix from customtool_ to custtoolset_.
• Rename the attribute exposeto3rdpartyagents to exposetoaiconnector.

Following these updates enables you to access execution logs, facilitating easier debugging and performance assessment for your custom tools.

For detailed guidance on implementing these updates, refer to the article titled How to Update Custom Tool Scripts for Execution Log Support in NetSuite 2026.1 (SuiteAnswers ID: 1024036).

New Custom Tools Page

NetSuite now features a new Custom Tools page, which provides a centralized interface for managing and viewing tools associated with your NetSuite account. You can find this page under Customization > Scripting > Custom Tools.

This page organizes tools from SuiteApps and account customization projects (ACPs) by toolset. Each toolset is an SDF object that groups related custom tool scripts. Features of the new page include:

• Expanding toolsets to view individual tools and their access permissions for AI clients.
• The ability to delete ACP toolsets directly from the Custom Tools page. (Note: SuiteApp toolsets cannot be deleted here; you must uninstall the associated SuiteApp to remove them.)

This enhancement simplifies the management of custom tools and their integrations with AI clients.

Who This Affects

• Administrators: For implementing and managing custom tool scripts.
• Developers: For modifying custom tools to support new functionalities and logging.
• Integration Specialists: For connecting external AI clients with NetSuite using custom tools.

Key Takeaways

• Custom tool scripts now support execution logging for better monitoring.
• A new Custom Tools page streamlines management of custom tools.
• Updates require modifications in both script definitions and SDF object schemas.
• Enhanced functionality boosts integration capabilities with external AI clients.
• Properly updating scripts and their definitions is crucial for utilizing these features effectively.