NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Item Group → Insert record

AI-generated

Summary

Create a new Item Group record in NetSuite with specified details and member items.

Inputs

  • Item Name/Number — The primary name or number for the new item group, up to 250 characters. This is a crucial identifier for the item group.
  • Description — A description for the item group that appears on sales forms.
  • Display Name/Code — An optional display name for the item group, up to 250 characters, that prints on sales forms.
  • External ID — An optional external identifier for the item group.
  • Inactive — Set to true to mark the item group as inactive.
  • Include Children — Set to true to share the item group with all sub-subsidiaries of selected subsidiaries.
  • Include Start/End Lines — Choose whether the start and end lines of the item group are referenced for sorting picking tickets.
  • Print Items — Set to true to display member items with their details on sales and purchase forms.
  • UPC Code — An internal UPC code for the item group, up to 999 characters.
  • Vendor Name/Code — The vendor's specific name for this item group, if different from the internal name.
  • Class — Specify the internal or external identifier of the class to associate with the item group.
  • Custom Form — Specify the internal identifier or reference name of a custom form to use for the item group.
  • Department — Specify the internal or external identifier of the department to associate with the item group.
  • Location — Specify the internal or external identifier of the location to associate with the item group.
  • Parent — Specify the internal or external identifier of a parent item group.
  • Subsidiary — Specify the internal or external identifier of the subsidiary to associate with the item group.
  • Item Type — Specify the internal identifier or reference name of the item type. Defaults to 'Group'.
  • Member — Define the individual items that are part of this group, including the item reference (ID or External ID), quantity, description, and other member-specific properties.
  • Translations — Provide localized display names, descriptions, and other details for different languages/locales.
  • Hierarchy Versions — Specify details for item hierarchy versions, including associated hierarchy nodes, start/end dates, and inclusion status.
  • Custom Fields — Add custom fields with their name, type, and corresponding value.
  • Prefer — Request asynchronous execution of the operation by setting this to 'respond-async'.
  • X - Net Suite - Idempotency - Key — A unique UUID key for asynchronous requests to ensure the operation is executed only once.
  • X - Net Suite - Property Name Validation — Sets the strictness of property name validation (Error, Warning, or Ignore).
  • X - Net Suite - Property Value Validation — Sets the strictness of property value validation (Error, Warning, or Ignore).

Output shape

a single record

Returns the newly created NetSuite Item Group record, including its internal id and other properties. If 'Debug Mode' is enabled, the output will also contain the full request and response information.

Examples

Example 1: Create a basic item group

Set 'Item Name/Number' to 'Basic Group 1'.

Example 2: Create an item group with multiple member items

Set 'Item Name/Number' and add multiple entries under 'Member', specifying 'Item' IDs and 'Quantity' for each.

Example 3: Create an item group with a custom field

Set 'Item Name/Number', then add a 'Custom Field', selecting the 'Field Name', 'Field Type', and 'Value'.

Discussion