Acumatica API - Endpoint Default 24 200 001Install

Summary

Insert or update an Employee record in Acumatica by specifying detailed employee data, including personal info, contact details, roles, settings, and related entities.

Inputs

• Attributes — Multiple attribute entries each with identifier, description, active status, required flag, value, and related note ID.
• Contact Info — Contact details including activities, status, dates, owner, project info, and workgroup.
• Address — Employee address fields such as address lines, city, country, postal code, state, and validation status.
• Override Account Address — Boolean to specify if account address should be overridden.
• Address Validated — Boolean indicating if the address is validated.
• Attention — Attention field for the address or contact.
• Business Account — The associated business account identifier.
• Campaigns — Multiple marketing campaign entries tied to the employee with campaign ID, name, contact ID, and stage.
• Cases — Multiple case records linked to the employee with IDs, dates, owner, status and severity.
• Company Name — Company name of the employee.
• Contact Class — Classification for the contact.
• Contact ID — Unique numeric identifier for the contact.
• Contact Method — Preferred contact method.
• Converted By — Identifier of who converted the contact.
• Date Of Birth — Employee's date of birth.
• Display Name — Display name of the employee.
• Do Not Call — Boolean flag indicating if the employee should not be called.
• Do Not Email — Boolean flag indicating if the employee should not be emailed.
• Do Not Fax — Boolean flag indicating if the employee should not be faxed.
• Do Not Mail — Boolean flag indicating if the employee should not be mailed.
• Duplicates — Multiple duplicate records related to this employee with details such as business account and email.
• Email — Email address of the employee.
• Fax — Fax number of the employee.
• Fax Type — Type of fax number.
• First Name — First name of the employee.
• Gender — Gender of the employee.
• Image — Image associated with the employee.
• Job Title — Job title of the employee.
• Language Or Locale — Language or locale preference.
• Last Incoming Activity — Timestamp of last incoming activity.
• Last Modified Date Time — Last modification timestamp.
• Last Name — Last name of the employee.
• Last Outgoing Activity — Timestamp of last outgoing activity.
• Marital Status — Marital status.
• Marketing Lists — Marketing list entries associated with the employee.
• Middle Name — Middle name of the employee.
• No Marketing — Boolean flag to exclude from marketing.
• No Mass Mail — Boolean flag to exclude from mass mail.
• Notifications — Multiple notification entries related to the employee.
• Opportunities — Multiple sales opportunity entries for the employee.
• Owner — Owner identifier.
• Owner Employee Name — Name of the owner employee.
• Parent Account — Parent account identifier.
• Phone1 — Primary phone number.
• Phone1 Type — Type of primary phone.
• Phone2 — Secondary phone number.
• Phone2 Type — Type of secondary phone.
• Phone3 — Third phone number.
• Phone3 Type — Type of third phone.
• Qualification Date — Date of qualification.
• Reason — Reason associated with employee status or changes.
• Relations — Multiple relation entries including associated accounts and contact details.
• Role Assignments — Multiple role assignments for the employee.
• Source — Source info of the employee record.
• Source Campaign — Source campaign identifier.
• Spouse Or Partner Name — Name of spouse or partner.
• Status — Status of the employee.
• Synchronize — Boolean flag to synchronize the employee record.
• Title — Title or salutation.
• Type — Type of employee.
• User Info — User authentication info, login, password, and assigned roles with details.
• Web Site — Employee website URL.
• Workgroup — Workgroup identifier.
• Workgroup Description — Description of the workgroup.
• Note ID — Note ID related to the employee.
• Full Name — Full name of the employee.
• Ext Ref Nbr — External reference number.
• Delegates — List of delegates assigned with delegation details and active status.
• Employee Settings — Settings related to branch, calendar, currency, department, employee class, overrides, and reporting.
• Employment History — Multiple employment history items with start/end dates, position, and eligibility details.
• Financial Settings — Financial configuration including accounts, subaccounts, payment instructions, tax zone, and terms.
• Additional Fields — Additional optional fields like EmployeeID, EmployeeName, LastModifiedDateTime, and Status.

Output shape

a single Employee record object reflecting the created or updated data

Returns the updated Employee data after insertion or update. Fields are structured according to Acumatica API. Operation supports providing a wide range of detailed employee info including nested related entities. Optional fields can be omitted if not needed.

Examples

Example 1: Create a new employee with contact info and employment history

Supply required personal information, contact details, and employment history items. Call the Insert/Update operation to save or update the employee in Acumatica.

Links

• n8n community nodes installation guide