Execute an employee creation intent
Carry out an employee creation intent: creates the employee (or updates the one the onboarding already holds) from the intent, links them to the onboarding, cancels a leftover offboarding, adds them to the company in Clerk — a real user account — links the employee to its task and completes the task. Rarely needed: the employee is created on its own when the task is created without a date or wakes up on its date. Use it to retry after a refusal left the task PENDING with a comment. This is the only way to complete an EMPLOYEE_CREATION task by hand: updateTaskStatus refuses it with TaskLockedByTypeError naming this operation. Safe to retry: an intent executed earlier answers outcome: ALREADY_EXECUTED and creates nothing again. Refused with EMPLOYEE_INFORMATION_INCOMPLETE (first name, last name, work email and start date are all required: fix them with updateEmployeeCreationIntent), TICKET_SCHEDULED before a scheduled task wakes up, TICKET_CLOSED, EXECUTION_IN_PROGRESS, INVALID_EMAIL, FAIL_TO_CREATE_OR_UPDATE_EMPLOYEE; a refusal leaves the task PENDING with an internal comment on the ticket. completeOnboarding closes a whole onboarding without this task; use this operation for an EMPLOYEE_CREATION task.
Authorizations
Use your Primo API key in the Authorization header as Bearer <API_KEY>.