NetSuite REST Azerion icon

NetSuite REST Azerion

Call NetSuite SuiteTalk REST operations.

Actions981

Employee → Insert or update record

AI-generated

Summary

Inserts or updates an Employee record in NetSuite via the REST API.

Inputs

  • isDebugMode — Enable full request/response debugging in the output.
  • authMethod — Authentication method to use; either 'oauth1' or 'oauth2'.
  • id (required) — External identifier of the employee; required for update operations.
  • additionalFields — Collection of extra fields to populate on the employee record.
  • externalId — External ID to reference the employee when creating a new record.
  • override — Boolean flag to override certain validation rules during the operation.
  • defaultShipping — If true, sets the employee as the default shipping address source.
  • defaultBilling — If true, sets the employee as the default billing address source.
  • firstName — Employee's given name.
  • lastName — Employee's family name.
  • email — Employee's email address.
  • hireDate — Date the employee was hired.

Output shape

a single employee record

The response contains the full employee object returned by NetSuite; fields not sent remain unchanged.

Examples

Example 1: Create a new employee with basic details

isDebugMode:false, authMethod:oauth1, externalId:'E12345', firstName:'Alice', lastName:'Smith', email:'alice@example.com', hireDate:'2023-01-15'

Example 2: Update an existing employee using its external identifier

isDebugMode:true, authMethod:oauth2, id:'123', additionalFields:{addressBook:{items:[{addressBookAddress_text:'123 Main St'}]}}, override:true

Example 3: Upsert employee, inserting if not exists, updating if exists

isDebugMode:false, authMethod:oauth1, externalId:'E98765', firstName:'Bob', lastName:'Jones', additionalFields:{department:{id:'1'}, addressBook:{items:[{addr1:'456 Oak Ave'}]}}

Links

Discussion