Skip to content
Foxx Cyberfoxxcyber/docs

Onboard a new employee, start to finish

Every step from an empty HR area to a new hire's first day: skills, job profiles, the onboarding checklist, hiring with a start date, and the record HR keeps.

Onboarding in Foxx HQ runs through Hiring, even when you have already chosen the person. Hiring someone from an opening creates their account, fills in their HR record and starts their onboarding checklist by itself. Creating a bare account under Administration → Users leaves all of that for you to do by hand.

This page puts the steps in order. Steps 1 to 4 are set up once. Steps 5 to 10 are what you do for each new person.

Before you start

  • You are a company administrator or hold the HR admin grant. Department leads with HR enabled can hire and onboard people for their own departments, but not do the setup. See Human Resources overview.
  • Human Resources is turned on under Administration → Modules. See Modules.
  • Email is set up under Administration → Email. The invitation in step 7 is emailed. Without email the hire is recorded but nothing is sent. See Email.
  • Your departments exist, with their members and leads. Leads approve their people's leave, timecards and expenses. See Users, departments and teams.

Human Resources is behind the person icon in the top bar. The screenshots on this page come from a demo organization.

1. Build the skill catalog

Skills are what people rate themselves on, what job profiles require and what evaluations assess.

  1. Open Human Resources → Skills & job profiles.
  2. Proficiency levels: there are always five ranks. Click Rename to change a label. The defaults are Aware, Working, Proficient, Advanced and Expert.
  3. Categories: type a name under New category and click Add category. Categories only group skills for reading.
  4. Skills: enter the Label, an optional Description, choose a Category and click Add skill. Repeat for each skill.

The Skill catalog: five proficiency levels with Rename buttons, two categories, and five skills each with a description, a category and an Active badge

How to tell it worked: each skill is listed with its category and an Active badge.

Skills and categories can't be imported or deleted. To retire one, click Edit and untick In use. It stays on record but is no longer offered.

2. Describe each role as a job profile

A job profile is a role: the skills and certifications it needs. A new hire takes on the profile of the opening they were hired from, and their My gap page compares their skills against it.

  1. On the skill catalog, click Job architecture.
  2. Optional: under Job families, add a family such as Programs to group related roles.
  3. Under New job profile, enter the Title, choose the Family, and fill in Grade and Level rank if you use them. Click Create profile. The profile opens.
  4. Under Require a skill, choose the Skill, the Required level and the Weight, then click Add required skill. Required skills count toward readiness; Preferred ones don't. Repeat for each skill.
  5. To require a certification, add it to Human Resources → Certification catalog first, then choose it under Required certifications.
  6. In the Profile card, optionally set the Department, the Next role (the step up the career ladder), a description and the responsibilities.

A job profile, Program Coordinator in the Programs family at grade P2, requiring Youth tutoring and Volunteer coordination at level 3, Family outreach at level 2, and Spanish at level 2 as preferred

How to tell it worked: the Required skills table lists each skill with its level and weight.

3. Set up the onboarding checklist

Every new hire's onboarding is a copy of this checklist, taken when their onboarding starts. Editing it later doesn't change onboardings already running.

  1. Open Human Resources → Onboarding and click Edit checklist template.
  2. Foxx HQ starts you with seven tasks: offer letter and NDA, I-9, background check, laptop and accounts, security awareness training, payroll and benefits, and a manager introduction. Use … on a row to Edit or Delete it.
  3. To add a task, enter its Title, choose who is Responsible (hr, it, manager or employee) and click Add task.
  4. Optional: choose a Linked form. The task then completes by itself when the new hire submits that form, and the form waits in their Inbox. Build and publish the form in Forms first.

The onboarding checklist template: eight tasks in order, each with its responsible role, the last one linked to the Code of conduct 2026 form

Responsible is a label. Foxx HQ doesn't notify IT or the manager about their tasks, so tell them yourself.

4. Set up time and leave

A new hire's first timecard needs charge codes to book hours against, and a leave request needs leave types. Set them up once under Human Resources → Charge codes and Leave types & balances. See Time and leave.

If you offer benefits, activate a plan year under Benefits admin. Every hire from step 7 onward then gets a 30-day enrollment window.

5. Create an opening for the role

Do this even when you have already chosen the person. The opening is where their job title, department and job profile come from.

  1. Open Human Resources → Hiring and click New opening.
  2. Enter the Title (it becomes their job title), choose the Employment type, the Job profile from step 2, and the Department they will join.
  3. Click Create opening.

The New opening form for a Food Pantry Program Coordinator: location, full time, the Program Coordinator job profile, a description, and the Programs department

A new opening is a draft: only your team sees it, and it isn't on the careers page. If you have already chosen the person, leave it as a draft. To recruit, open it for applications; see Hiring.

6. Add the person as an applicant

  1. Open Human Resources → Hiring → All applicants and click Add applicant.
  2. Choose the Opening, and enter their Name and the Email they will sign in with. Add a Note if you like.
  3. Click Add applicant. Their applicant page opens.

The Add applicant form with the Food Pantry Program Coordinator opening, Jamie Ortiz's name and email, and a note

7. Hire them, with their start date

  1. On the applicant's page, click Hire….
  2. Enter their Start date. It becomes their hire date and the start of their first position. Leave it empty to use the day they accept the invitation.
  3. Click Hire and invite.

The Hire dialog with a Start date of 11/02/2026 and the Hire and invite button

They get an email with a link to set their password. The link works once, for seven days. The applicant page shows the invitation and the start date.

Jamie Ortiz's applicant page after hiring: Hired, an Account card, an Invitation card that says Accepted and Starts Nov 2, 2026, and the history

If the email didn't go, set up email, then use … → Re-send the invitation. The old link stops working.

8. They accept the invitation

The new hire opens the link and chooses a password: at least 12 characters, using 3 of uppercase, lowercase, digits and symbols.

The invitation page: Welcome, Jamie Ortiz, with the password and confirm fields, the password rules and the Set password button

The moment they click Set password, Foxx HQ:

  • creates their account as an employee;
  • adds them to the opening's department as a member;
  • fills in their HR record: job title, hire date, job profile, and the first line of their position history;
  • starts their onboarding checklist from the template;
  • opens their benefits enrollment window, if a plan year is active.

9. Work their onboarding checklist

  1. Open Human Resources → Onboarding. Their checklist is listed with its progress.
  2. Click their name, then click Mark done on each task as it is done. Reopen undoes it.

The Onboarding page: Jamie Ortiz's checklist at 0 of 8, In progress, and the Start onboarding by hand form

A task with a linked form shows Awaiting form and has no button. It completes when the new hire submits the form.

Jamie Ortiz's onboarding checklist: eight tasks with their responsible role and a Mark done button, the last one Awaiting form

The new hire can't see this checklist. Only HR and their department's leads can.

10. Finish their record

Open Human Resources → HR directory and click their name.

  • Profile: fill in the Employee number and Phone, and correct the Job title or Hire date if needed. Click Save profile.
  • Who they report to: set it in My organization (in the workspace sidebar, under Manage). Their leave, timecards and expenses go to that person for approval.
  • Lead instead of member: change their role on the department's Members card under Administration → Departments.
  • Contractor: hiring always creates an employee, even for a Contract opening. Change their type under Administration → Users → the person → Person type. Contractors get no benefits and accrue no leave.

Jamie Ortiz's employee record: the Profile form with job title, employee number CH-016, hire date 11/02/2026 and phone, the position history from Nov 2, 2026, and the Transfer or promote and Separation forms

What the new hire sees

They sign in to the workspace and see Self-service in Human Resources: timecards, leave, expenses, benefits, goals, skills, certifications, evaluations and their employee profile. Forms from their checklist wait in their Inbox.

The new hire's Inbox under My Work, with the Code of conduct 2026 form to complete

Good first things to point them at:

  • Skills: rate themselves against their job profile. Their manager confirms the ratings under Skill validation, and My gap shows what the role still needs.
  • Certifications: record credentials with their expiry dates.
  • Timecards: their first week.
  • Training: courses you assign them. See Training.

Someone who is already working

For a person who joined before you used Foxx HQ, skip the invitation:

  1. Administration → Users → New user: name, email and a temporary password. Give it to them in person or by phone. On their page, click Force reset so they choose their own at first sign-in. See Users, departments and teams.
  2. Add them to their department under Administration → Departments.
  3. Open their record in HR directory and fill in the Profile: job title, employee number, hire date and phone.
  4. Assign their role on the job profile's page: Assign this profile.
  5. If they still need onboarding, open Human Resources → Onboarding and use Start onboarding by hand.

This path writes no position history. Their first entry appears when you transfer or promote them.

Troubleshooting

The hire happened but no email went. Email isn't set up. Set it up under Administration → Email, then use … → Re-send the invitation on the applicant.

The invitation link says it expired or was used. Links work once, for seven days. Re-send the invitation; the new link replaces the old one.

"Already has an account here." The address belongs to an existing user. Use Someone who is already working instead.

No checklist appeared after they set their password. The checklist starts only for a hire from a staff opening. Start one by hand under Human Resources → Onboarding.

Their hire date is the day they accepted. No start date was entered when hiring. Correct it on their record in HR directory.

A task with a linked form says the form isn't available. The form isn't published. Publish it in Forms; onboardings started after that get it.

Last updated October 21, 2026