Create employee
Creates an employee record with its identity, employment terms, salary and payroll terms, bank account, and receipt email. An RFC already assigned to an employee in the organization returns 409 conflict; retrieve and update the existing employee by employeeId. Saving never requires payroll readiness; the response reports it.
- Endpoint
POST /v1/employees- Authorization
- Required permission: `employees:manage`.
- Environments
- Production and sandbox
- Idempotency
- Required for safe retries.
List employees GET
Lists payroll employees with the documented search and pagination controls while preserving organization scope.
Get employee GET
Returns one organization-owned payroll employee, the profile fields required by neighboring payroll operations, and payrollReadiness: what still stops exac from calculating and stamping the employee's ordinary payroll. An employee paid by individual receipts is outside that payroll and reports no issues for it. A last_receipt_deductions_missing issue means the employee's last receipt took deductions (an INFONAVIT credit, for one) of types payroll.fixedDeductions lacks; lastReceiptDeductions lists them per pay period: add them to payroll.fixedDeductions, or send payroll.lastReceiptDeductionsDismissed true to decide against them. A newer receipt asks again.