NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Contact Role → Insert record

AI-generated

Summary

Create a new Contact Role record in NetSuite via the REST API, optionally setting standard attributes, custom fields, and request preferences, and optionally returning full request/response details.

Inputs

  • isDebugMode — Include raw request and response data in the output.
  • additionalFields — Standard Contact Role properties such as Name, Description, External ID, Inactive flag, Preference headers (Prefer, X‑NetSuite‑Idempotency‑Key, X‑NetSuite‑PropertyNameValidation, X‑NetSuite‑PropertyValueValidation) and reference identifiers (refName, replace).
  • customFields — Custom field entries; each requires a Field Name, type (boolean, dateTime, multiSelect, number, select, string), and a corresponding Value matching that type.

Output shape

a JSON object representing the created Contact Role record, or, if Debug Mode is true, an object with the request payload and response headers, body, and status.

The response contains the record’s system fields (id, internalId, externalId, lastModifiedDate). Custom fields are returned under their field names if populated by NetSuite. “Prefer” may trigger asynchronous creation and will include a Preference‑applied header. Error handling is performed by the executor; failures will throw an n8n error instead of a structured output.

Examples

Example 1: Create a basic Contact Role

Set the Name to "Sales Associate", Description to "Handles sales queries", leave other fields empty.

Example 2: Add custom field to Contact Role

Define a custom boolean field "PreferredPartner" with value true, plus Name "Partner Lead".

Example 3: Enable debugging while inserting

Toggle Debug Mode, set Name "Debug Role", and review the output for request/response details.

Discussion