NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Description Item → Insert record

AI-generated

Summary

Create a new Description Item record in NetSuite via REST API, supplying optional item properties, custom fields, and debugging information.

Inputs

  • isDebugMode — Include full request and response data in the output node result.
  • customFields — Optional list of custom field name/value pairs to add to the item.
  • additionalFields — Optional Description Item specific fields. Accepted options:
  • class (id or externalId)
  • customForm (id or refName)
  • createdDate (dateTime)
  • department (id or externalId)
  • description (string)
  • externalId (string)
  • isInactive (boolean)
  • includeChildren (boolean)
  • id (string)
  • itemId (string)
  • itemType (id or refName)
  • lastModifiedDate (dateTime)
  • location (id or externalId)
  • Prefer (string: '', 'respond-async')
  • refName (string)
  • replace (string)
  • subsidiary (id or externalId)
  • translations (list of translation objects with fields such as storeDetailedDescription, displayName, featuredDescription, language, locale refName, storeDescription, storeDisplayName)
  • X-NetSuite-Idempotency-Key (string)
  • X-NetSuite-PropertyNameValidation (string: '', 'Error', 'Warning', 'Ignore')
  • X-NetSuite-PropertyValueValidation (string: '', 'Error', 'Warning', 'Ignore')

Output shape

Returns the newly created Description Item record as a JSON object. If debug mode is enabled, the output also contains the raw request and response details inside the 'debug' field.

The returned object matches NetSuite’s Description Item record schema; pagination is not applicable for insert operations. Errors will surface as node errors.

Examples

Example 1: Create a Description Item with a basic name and description

isDebugMode: false
customFields: []
additionalFields: {itemId: 'Service Widget', description: 'A useful service widget.'}

Example 2: Create a Description Item with a custom field and specific form

isDebugMode: false
customFields: [{fieldName:'warrantyPeriod',fieldType:'string',value:'12 months'}]
additionalFields: {itemId: 'Service Gadget', customForm:{id:'29'}}

Example 3: Create a Description Item and enable debug output

isDebugMode: true
customFields: []
additionalFields: {itemId: 'Debug Item', description: 'Testing debug mode.'}

Discussion