NetSuite REST Azerion icon

NetSuite REST Azerion

Call NetSuite SuiteTalk REST operations.

Actions981

Bin → Insert or update record

AI-generated

Summary

Insert or update a NetSuite Bin record (upsert) using the external ID supplied in the Id field.

Inputs

  • isDebugMode — Include full request and response details in the output when true.
  • authMethod — Authentication method: OAuth1 or OAuth2.
  • id (required) — External identifier of the Bin record; used in the URL path to determine insert vs. update.
  • additionalFields — Standard Bin fields such as Bin Number, External ID, Inactive flag, Memo, Location, Inventory Balance, etc.
  • customFields — One or more custom fields to set on the Bin record; each field includes Field Name, Field Type, and Value.
  • Prefer — Set to 'respond-async' to execute the request asynchronously.
  • replace — Comma‑separated list of sublist names whose lines should be fully replaced.
  • replaceSelectedFields — When true, all fields to be cleared in an update must be listed in the Replace parameter.
  • X-NetSuite-Idempotency-Key — Idempotency key (UUID) for asynchronous requests.
  • X-NetSuite-PropertyNameValidation — Strictness of property name validation (Error, Warning, Ignore).
  • X-NetSuite-PropertyValueValidation — Strictness of property value validation (Error, Warning, Ignore).

Output shape

The Bin record returned by NetSuite, optionally augmented with debug information when isDebugMode is enabled. Includes internalId, externalId, binNumber, and any other fields that were set or returned by the API.

If the request is asynchronous (Prefer: respond-async), the response contains a status indicating asynchronous execution and the idempotency key is honored.

Examples

Example 1: Create a new Bin if it does not exist, or update an existing Bin using its external ID.

Set Id to the external ID, fill in additionalFields (e.g., Bin Number, Location), optionally add customFields, and leave other flags at defaults.

Links

Discussion