Custom Tool Script Enhancements in NetSuite

TL;DR Opening

Starting in the Weekly Update on February 16, 2026, NetSuite introduces enhancements to custom tool scripts in version 2026.1, including execution log support, a centralized management page for better organization and oversight of tools, and binary file support for the N/https module. These updates streamline debugging, facilitate the optimization of custom tools, and handle binary files used with the NetSuite AI Connector Service.

What's New

Custom Tool Script and SDF Object Updates

The custom tool script type and its corresponding SuiteCloud Development Framework (SDF) object have undergone significant updates in NetSuite 2026.1. Notably, you can now access execution logs for custom tool scripts via the Script Execution Logs page located at Customization > Scripting > Script Execution Logs.

To leverage this new logging feature, existing and new custom tool scripts must be updated. Here’s what you need to do:

• For Custom Tool Scripts:

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

• For SDF Object XML Definitions:

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

These changes enhance script monitoring and troubleshooting, enabling developers to better manage their custom tools. For detailed guidance, refer to How to Update Custom Tool Scripts for Execution Log Support in NetSuite 2026.1 (SuiteAnswers ID: 1024036).

New Custom Tools Page

In addition to script and SDF updates, NetSuite now features a new Custom Tools page. This page centralizes the viewing and management of custom tools available in your account. Here, you can find tools from SuiteApps and account customization projects (ACPs), organized by toolset, which refers to the new SDF object structure.

To access the Custom Tools page, navigate to Customization > Scripting > Custom Tools.

• Expanding a toolset reveals individual tools and associated permissions required for access via the AI client.
• You can delete ACP toolsets directly, but SuiteApp toolsets cannot be deleted from this page—use the link to the Installed SuiteApps page for uninstallation.

The new page enhances user experience by simplifying access and visibility into custom tool functionalities.

Binary File Support for N/https Module

In addition, NetSuite 2026.1 introduces binary file support for the N/https module. You can now send a binary file in SuiteScript by converting the file contents to a Uint8Array using Uint8Array.fromBase64(), then passing the result in the options.body parameter of https.post(options). Only one file can be sent per request.

For details, see https.post(options).

Key Takeaways

• Custom tool scripts now support execution logs for enhanced troubleshooting.
• The new Custom Tools page centralizes tool management for better visibility.
• Updates include changes to SDF object structure, enhancing compatibility with the NetSuite AI Connector Service.
• Developers must update existing tools to utilize the new features effectively.