Acumatica API - Endpoint Default 23 200 001 icon

Acumatica API - Endpoint Default 23 200 001

Interact with Acumatica Endpoint Default/23.200.001

Actions478

Employee → Insert/Update

AI-generated

Summary

Insert or update an employee record in Acumatica via the Employee upsert operation.

Inputs

  • EmployeeID — The unique identifier for the employee; if provided, updates the existing record; otherwise a new employee is created.
  • EmployeeName — The employee's display name.
  • FirstName — The employee's first name.
  • LastName — The employee's last name.
  • ContactInfo — Collection of contact details such as phone numbers, email, fax, and activity information.
  • Address — Postal address fields (line 1, line 2, city, state, country, postal code) and validation flag.
  • Attributes — Custom attribute key/value pairs with ID, description, active flag, and reference note ID.
  • BusinessAccount — Identifier of the business account associated with the employee.
  • Campaigns — List of marketing campaigns linked to the employee.
  • Cases — Support cases associated with the employee.
  • Duplicates — Potential duplicate records detected during the operation.
  • Email — Primary email address.
  • Fax — Fax number.
  • Gender — Gender of the employee.
  • JobTitle — Job title.
  • LanguageOrLocale — Language or locale setting.
  • MaritalStatus — Marital status.
  • MarketingLists — Marketing list subscriptions.
  • MiddleName — Middle name.
  • NoMassMail — Opt‑out flag for mass mail.
  • NoMarketing — Opt‑out flag for marketing communications.
  • Notifications — Email notification settings.
  • Opportunities — Sales opportunity records linked to the employee.
  • Owner — Owner of the employee record.
  • Phone1 — Primary phone number.
  • Phone2 — Secondary phone number.
  • Phone3 — Tertiary phone number.
  • QualificationDate — Date the employee was qualified.
  • Reason — Reason for the employee record.
  • Relations — Related records such as accounts, contacts, documents.
  • RoleAssignments — Security role assignments for the employee.
  • Source — Source of the employee record (e.g., website, referral).

Output shape

object

Returns the Acumatica API response containing the created or updated employee record, including system fields such as note ID, last modified date, and status.

Examples

Example 1: Create a new employee

Set EmployeeName, FirstName, LastName, Email, and optionally Address or ContactInfo. Leave EmployeeID blank to trigger an insert.

Example 2: Update an existing employee

Provide the known EmployeeID along with any fields to change. Only non‑empty values are sent; omitted fields retain their current values.

Links

Discussion