Onboard Employee

Onboard Employee

Create a Factorial employee, assign teams, and invite them.

1. Create the employee record from the supplied profile fields.
2. Read the newly created employee back to confirm its id and stored profile before assigning teams.
3. Assign the new hire to the requested teams by writing the team_ids onto the employee record (Factorial exposes team membership through the employee resource rather than a dedicated teams endpoint).
4. Send the Factorial platform invitation so the new hire can sign in.

What you'll need to have ready

• first_name: The new hire's first name.
• last_name: The new hire's last name.
• email: The new hire's work email address.
• start_date: The employment start date (YYYY-MM-DD).
• job_title: The job title for the new hire.
• manager_id: The id of the employee's manager.
• team_ids: The team ids the new hire should belong to.

For your developer

Arazzo workflow factorial:onboard-employee, 4 operations: createEmployee → getEmployee → updateEmployee → inviteEmployee. Specs on APIs.io.