How to Programmatically Create a Folder in NetSuite Using SuiteScript?

To create a folder programmatically in NetSuite, developers can leverage SuiteScript 2.x. The process involves creating a new folder record, setting its properties such as the parent folder and name, and then saving the record. The following SuiteScript 2.x example demonstrates how to create a root-level folder:

javascript
/**
 * @NApiVersion 2.x
 * @NModuleScope SameAccount
 */
define(['N/record', 'N/log'], function(record, log) {
    function createNewFolderExample() {
        try {
            // Create a new folder record
            var folderRecord = record.create({
                type: record.Type.FOLDER,
                isDynamic: true // Set to true if you need to set values dynamically
            });

            // Set the parent field to create a root-level folder
            folderRecord.setValue({
                fieldId: 'parent',
                value: ''
            });

            // Set the name of the new folder
            folderRecord.setValue({
                fieldId: 'name',
                value: 'Created from SuiteScript'
            });

            // Save the folder record to create it in NetSuite
            var folderId = folderRecord.save();

            // Log the ID of the newly created folder for confirmation
            log.debug({
                title: 'New Folder Created Successfully',
                details: 'New folder ID: ' + folderId
            });

            return folderId; // Return the ID of the new folder

        } catch (e) {
            log.error({
                title: 'Error Creating Folder',
                details: e.message
            });
            return null;
        }
    }
    return {
        createNewFolderExample: createNewFolderExample
    };
});

This script utilizes the N/record module to create and save the folder, and the N/log module to output the new folder's ID for debugging purposes. The parent field is set to an empty string to designate the folder as a top-level folder in the File Cabinet.