NetSuite REST Azerion icon

NetSuite REST Azerion

Call NetSuite SuiteTalk REST operations.

Actions981

Competitor → Insert or update record

AI-generated

Summary

Update or insert a Competitor record in NetSuite using its external identifier via PUT /competitor/{id}.

Inputs

  • id (required) — External identifier. Mapped to the URL path segment {id}. Required.
  • authMethod — Authentication method. Options: OAuth1 or OAuth2. Default: oauth1.
  • isDebugMode — Whether to include full request and response info in the n8n output. Default: false.
  • name — Enter the name of your competitor. Selected on the Competitors subtab of opportunity records.
  • description — Enter a description of this competitor.
  • isInactive — Check to inactivate this competitor. Inactive competitors do not appear on sales transactions. Default: false.
  • url — Enter the URL of the competitor’s Web site.
  • productService — Enter information about the products or services offered by this competitor.
  • strategy — Describe a strategy sales reps can use to win an opportunity over this competitor.
  • strengths — Describe or list the strengths of this competitor.
  • weaknesses — Describe or list the weaknesses of this competitor.
  • externalId — External ID for the competitor.
  • replace — The names of sublists on this record. All sublist lines will be replaced with lines specified in the request. Names delimited by comma.
  • replaceSelectedFields — If true, all fields that should be deleted in the update request must be included in the 'replace' query parameter. Default: false.
  • X-NetSuite-Idempotency-Key — A user-defined unique idempotency key for asynchronous requests (UUID format per RFC 4122). Ignored for synchronous requests.
  • X-NetSuite-PropertyNameValidation — Sets the strictness of property name validation. Options: '', 'Error', 'Warning', 'Ignore'. Default: ''.
  • X-NetSuite-PropertyValueValidation — Sets the strictness of property value validation. Options: '', 'Error', 'Warning', 'Ignore'. Default: ''.
  • Prefer — Execute the request asynchronously. Use '' for synchronous, 'respond-async' for asynchronous execution. Response includes 'Preference-applied: respond-async' header when async.
  • additionalFields — Collection of additional fields for the competitor record. Supports sub-options including customForm, refName, description, externalId, isInactive, internal id, lastModifiedDate, name, productService, Prefer, strengths, weaknesses, url, and validation headers.
  • customFields — Fixed collection of custom fields. Each entry requires a fieldName (loaded via loadCustomFields) and a fieldType (boolean, dateTime, multiSelect, number, select, string). Value type depends on fieldType.

Output shape

The NetSuite REST API response containing the updated or created Competitor record metadata.

If isDebugMode is true, the n8n item output includes full request and response details.

Examples

Example 1: Update an existing competitor's name and status.

Set id to the competitor's external ID, name to the new name, and isInactive to false (or true to inactivate). AuthMethod defaults to OAuth1 unless changed.

Links

Discussion