Update Employee

Update an employee in NetSuite.

Options

Field Definition Type Required

Use Custom Fields?

Choose an option to create input fields:

  • Yes: Include custom fields with the input fields.

  • No: Use only the default input fields of the card.

The card can display up to 100 primitive type (Boolean, number, or text) custom fields.

Use extensible input fields to add any additional fields that the card doesn't generate, including complex object fields.

Dropdown

TRUE

Replace Sublist Items?

Choose an option to update input values:

  • Yes: Replace sublist items with new values.

  • No: Add new values to the existing sublist items.

Dropdown

TRUE

Pass Empty Values?

Specifies whether empty values are passed to the remote system, instead of skipping an update to the field.

  • Yes: For any input field on the card that is blank or given a null value, the update includes the empty field. This clears any existing value on the remote system for that field.
  • No: For any input field on the card that is blank or given a null value, nothing is sent to the remote system for this field. Any existing value on the remote system remains unchanged.

This option also affects lists or objects, but doesn't affect dropdown types.

Dropdown

TRUE

Input

Field Definition Type Required

Employee

ID

The ID of the employee.

Text

TRUE

Fields

Entity ID

Unique identifier for the employee record.

This is shown as the Employee ID in the NetSuite interface.

Text

FALSE

External ID

The external ID of the employee.

Text

FALSE

First Name

The first name of the employee.

Text

FALSE

Middle Name

The middle name of the employee.

Text

FALSE

Last Name

The last name of the employee.

Text

FALSE

Email

The email of the employee.

Text

FALSE

Is Inactive

Specifies whether the employee is inactive.

True/False

FALSE

Mr/Ms

The employee's salutation, such as Mr. or Ms.

Text

FALSE

Initials

The initials of the employee.

Text

FALSE

Gender

The gender of the employee.

  • Blank: Use an empty value for the field.

  • Not Specified: The employee's gender field is explicitly unspecified.

  • Non-Binary: The employee identifies as non-binary.

  • Male: The employee identifies as a male.

  • Female: The employee identifies as a female.

Dropdown

FALSE

Ethnicity ID

The ID of the employee's ethnicity.

To find the available ethnicity values for your NetSuite account, open your NetSuite center and go to SetupAccountingEmployee Related ListsEthnicity.

Use the Internal ID value.

Text

FALSE

Marital Status ID

The marital status of the employee.

To find the available marital statuses for your NetSuite account, open your NetSuite center and go to SetupAccountingEmployee Related ListsMarital Statuses.

Use the Internal ID value.

Text

FALSE

Job Title

The employee's official job title.

Text

FALSE

Job Description

The description of the duties this person currently performs.

Text

FALSE

Supervisor ID

The ID of the employee's supervisor.

To find the ID of the supervisor, open your NetSuite center and go to ListsEmployeesEmployees.

Use the Internal ID value.

Text

FALSE

Time Approver ID

The ID of the person who approves the employee's time transactions.

To find the ID of the required person, open your NetSuite center and go to ListsEmployeesEmployees.

Use the Internal ID value.

Text

FALSE

Default Expense Report Currency ID

The ID of the employee's default expense report currency.

To find the ID of the required currency, open your NetSuite center and go to: ListsAccountingCurrencies.

Use the Internal ID value.

Text

FALSE

Available Currencies IDs

The list of IDs for the currencies available to the employee.

To find the ID of a currency, open your NetSuite center and go to: ListsAccountingCurrencies.

Use the Internal ID value.

List of Text

FALSE

Notes

Any comments included on the employee's record.

Text

FALSE

Image ID

The ID of the image file uploaded to the employee's account.

To find the ID of the required image, open your NetSuite center and go to DocumentsFilesImages.

Use the Internal ID value.

Text

FALSE

Phone

The phone number for the employee.

Text

FALSE

Office Phone

The office phone number of the employee.

Text

FALSE

Mobile Phone

The mobile phone number of the employee.

Text

FALSE

Home Phone

The home phone number of the employee.

Text

FALSE

Fax

The fax number for the employee.

Text

FALSE

Department ID

The ID of the employee's department.

To find the ID of the department, go to SetupCompanyDepartments.

Use the Internal ID value.

Text

FALSE

Subsidiary ID

The ID of the employee's subsidiary.

To find the ID of the subsidiary, go to SetupCompanySubsidiaries.

Use the Internal ID value.

Text

FALSE

Class ID

The ID of the employee's class.

To find the ID of the class, go to: SetupCompanyClasses.

Use the Internal ID value.

Text

FALSE

Location ID

The ID of the employee's location.

To find the ID of the location, go to SetupCompanyLocations.

Use the Internal ID value.

Text

FALSE

Social Security Number

The social security number of the employee, in the following format: 123-45-6789

Text

FALSE

Birth Date

The employee's birth date.

Date & Time

FALSE

Employee Type ID

The ID of the employee's type.

To find the ID of the type, go to SetupAccountingEmployee Related ListsEmployee Type.

Use the Internal ID value.

Text

FALSE

Employee Status ID

The ID of the employee's status.

To find the ID of the status, go to SetupAccountingEmployee Related ListsEmployee Status.

Use the Internal ID value.

Text

FALSE

Is Sales Representative

Identifies whether the employee is a sales representative or not.

True/False

FALSE

Is Support Representative

Identifies whether the employee is a support representative or not.

True/False

FALSE

Hire Date

The date this employee was hired.

Date & Time

FALSE

Last Review Date

The date of the employee's last salary evaluation.

Date & Time

FALSE

Next Review Date

The date of the employee's next salary evaluation.

Date & Time

FALSE

Termination Date

The employee's final date of employment.

Date & Time

FALSE

Default Job Resource Role ID

The ID of the employee's default job resource role.

To find the ID of the default job resource role, go to SetupAccountingProject Resource Roles.

Use the Internal ID value.

Text

FALSE

Expense Limit

The amount this employee can expense without approval from a supervisor or approver.

Number

FALSE

Expense Approver ID

The ID of the person that approves the employee's expense reports.

To find the ID of the expense approver, go to ListsEmployeesEmployees.

Use the Internal ID value.

Text

FALSE

Expense Approval Limit

The maximum amount that the employee can approve for an expense report if they're specified as an approver for another employee.

Number

FALSE

Is Project Resource

Indicates whether the employee is to be added as a resource on projects and tasks.

True/False

FALSE

Work Calendar ID

The ID of the employee's work calendar.

To find the ID of the work calendar, go to ListsEmployeesWork Calendars{required calendar name}.

Use the value of the id query parameter in your browser's URL.

Text

FALSE

Purchase Limit

The amount this employee can purchase without approval from a supervisor or approver.

Number

FALSE

Purchase Approver ID

The ID of the person that approves the employee's purchase requests.

To find the ID of the purchase approver, go to ListsEmployeesEmployees.

Use the Internal ID value.

Text

FALSE

Labor Cost

The employee's hourly overhead labor rate.

Number

FALSE

Purchase Approval Limit

The maximum amount that an employee is allowed to approve on a purchase request when specified as an approver for an employee.

Number

FALSE

Account

The account number for the employee's benefits provider.

Text

FALSE

Resident Status ID

The ID of the employee's resident status.

To find the ID of the resident status, go to SetupAccountingEmployee Related ListsResident Status.

Use the Internal ID value.

Text

FALSE

Visa Type ID

The ID of the employee's visa type.

To find the ID of the visa type, go to SetupAccountingEmployee Related ListsVisa Type.

Use the Internal ID value.

Text

FALSE

Visa Expiration Date

The expiration date of the employee's visa.

Date & Time

FALSE

Alien Number

The alien number of the employee.

Text

FALSE

Authorized To Work Until

The last date that the employee is authorized to work.

Date & Time

FALSE

Is I-9 Verified

Identifies whether the employee has completed an I-9 form.

True/False

FALSE

Has Login Access

Identifies whether the employee has access to NetSuite.

True/False

FALSE

Send Access Notification Email

Identifies whether to send an automatic email notifying this employee of access privileges.

True/False

FALSE

Password

The password of the employee.

Text

FALSE

Confirm Password

The password of the employee for verification.

Text

FALSE

Require Password Change

Identifies whether the user must change their password the next time they sign in.

True/False

FALSE

Roles

A list of the role IDs to assign to the employee.

To find the required role IDs for assignment, go to SetupUsers/RolesManage Roles.

Use the Internal ID values.

List of Text

FALSE

Custom Fields

Optionally, click the empty field under Click or drop here to create a custom field to include in the create employee request payload.

To get the list of available fields, make a request to the /metadata-catalog/employee relative URL using the {"Accept": "application/schema+json"} request header.

Output

Field Definition Type

Result

Status Code

The status code of the update request.

The successful update operation returns a 204 status code.

Number

Related topics

NetSuite connector

Cards in flows

NetSuite API