NetSuite SuiteTalk icon

NetSuite SuiteTalk

NetSuite REST API

Actions15

Insert Record

AI-generated

Summary

Create a NetSuite record of the selected type using each incoming item’s JSON as the record body. Optionally replace specified sublists with the lines in the request.

Inputs

  • Record Type (required) — Choose the record type to create; defaults to Sales Order. For Custom Record, also provide its required Custom Record Script ID.
  • Input item JSON (required) — Each incoming item’s JSON is sent as the record body.
  • Replace Sublists — Comma-separated sublist names whose existing lines should be replaced with the lines in the request. Unlisted sublists have lines added.
  • API Version — The UI offers V1, selected by default.
  • Options: Full Response — The UI exposes this option, but the insert implementation does not use it; output remains the operation’s success and record details.
  • Options: Max Retries — Number of retries for rate-limit and server errors; defaults to 5, with a UI range of 0–10.

Output shape

One item per input item, containing a single record-shaped JSON object.

Successful inserts return {"success":true,"id":...,"location":...,"recordType":...}; id and location are omitted when the API response does not provide them. Each output is paired with its input item. Errors follow the node’s continue-on-fail behavior.

Links

Discussion