Add your team
Add people with a role and a sign-in, then keep their work, certificates and onboarding in one place.
On this pageBefore you start
What a person can see and do in ONYX1 depends on the role you give them. Each active person, including a contractor, uses one of your plan's seats.
Before you start
- Only the owner and admins can add people.
- Only an owner can add another owner.
- Have the person's name and email ready. The email is their ONYX1 sign-in.
- An active person needs a free seat. Deactivating someone frees their seat and keeps their records.
Add a person
- Open Team from the menu.
- Select Add person in the Team header. The action is available to owners and admins on desktop and phone.
- Enter the person's Name and Email, then choose a Role. Roles and what each can do explains the seven roles.
- Choose how they get in. Email them an invite is selected by default. The link lasts 7 days and can be used once. They choose their own password from the link.
- If you are giving them their sign-in yourself, choose Set a temporary password and enter a password of at least 8 characters. When email delivery works, ONYX1 emails them a link to confirm their email, and they cannot sign in until they open it. They can change the password after signing in.
- Optionally enter an Hourly pay rate and iPayroll ID, tick or untick Hands in a weekly timesheet, and select Send invite or Add person.
With an email invite, ONYX1 sends the sign-in link to the address you entered when email delivery is configured. The link is tied to your workspace, expires after 7 days and works once. If delivery is not configured, the invite is not saved. If delivery fails after the invite is saved, the form reports that the email could not be delivered. Accepting the invite (setting a password and selecting Join the team) also confirms the person's email.
A temporary password also depends on email. When the email is sent, its subject is Confirm your ONYX1 email, and the person must open its link (it works for 24 hours) before their first sign-in. Give them their email address and temporary password as before. If they try to sign in first, ONYX1 shows Confirm your email first and, if email delivery works, can send a new link, at most once per person every 5 minutes. If delivery is not configured, the form refuses to add the person, because they could never confirm their email.
Seats
The Team page shows the number of active seats used, for example 8 of 10 used. The add drawer shows the seat the new person will use. When every seat is taken, it says At 10 of 10 seats this asks you to upgrade or deactivate someone.
To free a seat, open the person from Team and select Deactivate. Their sign-in is blocked, their records stay, and they move to Deactivated. Open that list and select the person to Reactivate them when a seat is free. On a phone, selecting a person opens a full-screen record with the same actions, except that Reset two-step sign-in is in the next iPhone build. Until then, reset it from Team on the web.
A person's record
Select a person on Team to open their record. It is a drawer on desktop and a full-screen sheet on a phone. The record has these tabs:
- Details shows their role and sign-in details. Owners and admins can manage another person's role, status, password, profile, pay and costing rates. Owners also see Two-step sign-in there, with Reset two-step sign-in for someone who is locked out of their authenticator app and has no backup codes left. Resetting signs the person out everywhere. When asked to confirm, use a code from your own authenticator app or one of your backup codes; supported browsers also offer Use a passkey. ONYX1 tries to email the person and tells you if it cannot. If your workspace requires two-step sign-in, they set it up again at their next sign-in. The same tab includes Extra page access for non-money pages, using the existing owner/admin access gate.
- Part-time hours is under Details. Part-time people are left out of crew comparisons. Usual hours are optional. If you enter Usual hours, choose Per day or Per week under Usual period. The review flags a day or week when recorded paid hours are more than 45 minutes below usual. A day with a shift still running is checked once that shift ends. A week still being filled in on a draft timesheet is checked once the calendar week ends. Per-day usual hours only check days with recorded time. An approved leave day skips the day check; a calendar week with any approved leave skips the weekly check. Public holidays are not adjusted. Flags never block approval. The owner can change this for anyone. An admin can change the setting for another team member only when that person is neither an owner nor an admin. Admins cannot change their own setting.
- Timesheets shows recent weekly sheets when your role can review them.
- Leave shows recent requests and the person's balance when your role can review leave.
- Certs shows certificates and gear held by that person.
- HR record shows onboarding progress to owners and admins. Select Open full record for the long employee record, including tax, KiwiSaver, address, bank and next-of-kin details.
- Bonuses is available to business managers.
Site supervisors can use the Team list and open people on desktop or phone without seeing rates. They cannot edit team access or HR information.
Mark someone as part time
- Open Team and select the person.
- Select Details and find Part-time hours.
- Tick Part time. To flag short hours, enter Usual hours and choose Per day or Per week under Usual period.
- Select Save.
Use Deactivate when the person leaves but their records should stay. Remove from team is only a true deletion when there is no linked history. Anyone with timesheets, signed forms or other linked records is deactivated instead so those records remain available.
The new-employee checklist
The new-employee checklist in Settings → Onboarding is the paperwork and setup list for each new person. Only the owner and admins can see or tick a checklist.
Set up the list:
- Open Settings → Onboarding.
- In New employee checklist, enter an item in Add a checklist item… and select Add item. Repeat for each item.
- Select Remove beside an item you no longer need.
Each person you add gets a copy of the list as it stands that day. Editing the list later changes it only for people you add after that.
Work through one person's checklist:
- Open Team and select the person.
- Open HR record, then select Open full record.
- In the Onboarding card, tick each item as it is done.
- To add an item for this person only, enter it in Add an item for this person… and select Add.
- Write anything still to chase in Notes and select Save notes.
The desktop Team list shows onboarding progress for owners and admins. The person record shows it in the HR record tab and the full record keeps the checklist and notes for internal use.
If something goes wrong
- That email can't be used. Please use a different email. The address already belongs to an ONYX1 account. Use another address.
- Email invites are not configured. Ask an admin to configure email delivery. Email delivery is not set up for your workspace. Invites and temporary-password sign-ins both need it.
- Email delivery is not configured here, and a new person must confirm their email before they can sign in. Choosing Set a temporary password needs email delivery too. Ask an admin to configure it.
- Person added, but the confirmation email could not be sent, so they cannot sign in yet. The account exists, but the confirmation link did not go out. Once email delivery works, the person tries to sign in. Once delivery works, a blocked sign-in can send a new link, at most once per person every 5 minutes.
- Invite created, but the email could not be delivered. Check email settings and send it again. Check email delivery, then add the invite again.
- Only an owner can add another owner. An admin cannot add or change an owner.
- Only an admin can change roles. Role changes are limited to owners and admins.
- You’ve used all your seats. Upgrade your plan or deactivate a user to add another. Deactivate someone or ask the owner about the plan.
- That invite has expired or has already been used. Ask an owner or admin to send a new invite.
- No onboarding checklist for this person yet. They were added before the checklist existed, or the template was empty. Select Set up checklist on the full record.
