Create Employee

Create an employee in NetSuite.

Options

Field	Definition	Type	Required
Autocreate Employee ID?	Choose an option to generate input values: Yes: Allow NetSuite to generate the Entity ID value. No: Set the Entity ID value using the input field.	Dropdown	TRUE
Use Custom Fields?	Choose an option for the use of custom input fields: Yes: Include custom fields in 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

Field

Definition

Type

Required

Autocreate Employee ID?

Choose an option to generate input values:

Yes: Allow NetSuite to generate the Entity ID value.
No: Set the Entity ID value using the input field.

Dropdown

TRUE

Use Custom Fields?

Choose an option for the use of custom input fields:

Yes: Include custom fields in 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

Input

Field	Definition	Type	Required
Employee
Entity ID	Unique identifier for the employee record. This is shown as the Employee ID in the NetSuite interface. This field doesn't appear if you set the Autocreate Employee ID? option to Yes.	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
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.
Password
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
Address
Label	A label for the address record.	Text	FALSE
Address 1	The first line of the address.	Text	FALSE
Address 2	The second line of the address.	Text	FALSE
Addressee	The addressee name for this address record.	Text	FALSE
Phone	The phone number of the addressee.	Text	FALSE
Attention	The name of the person to whom any shipment is addressed, as it should appear on shipping labels.	Text	FALSE
City	The city for the address record.	Text	FALSE
Country	The country for the address record.	Dropdown	FALSE
State/Province	The state or province for the address record.	Text	FALSE
Zip Code	The ZIP code for the address record.	Text	FALSE
Has Custom Text Address	Identifies whether the text entered in the Address component fields should appear in the free-form address text field. If set to True, provide a value for the Text Address field.	True/False	FALSE
Text Address	The text in this field overrides the content in the free-form address text field.	Text	FALSE
Is Default Billing	Identifies whether the address record is the default for billing purposes.	True/False	FALSE
Is Default Shipping	Identifies whether the address record is the default for shipping purposes.	True/False	FALSE

Output

Field	Definition	Type
Employee
ID	The ID of the employee.	Text

Create Employee

Options

Input

Output

Related topics