Devices and agents
New hires
One request for a client's new employee makes their Microsoft 365 account with licenses, groups and a manager, and sets up their device, and the client follows it on their status page. Pro +.
When a client hires someone, they need an account, licenses, the right groups and a computer that is set up for them on their first day. A new-hire request does all of it from one form: Enlist makes the Microsoft 365 account, then waits for their device, which sets itself up as theirs when it is installed. The client follows each step on their status page. New hires are part of Pro +.
Before you start #
- To make accounts, connect the client's Microsoft 365 tenant in the client's settings (see Microsoft 365). The connection needs these Microsoft Graph application permissions:
User.ReadWrite.All,GroupMember.ReadWrite.All,Group.Read.AllandOrganization.Read.All; after granting them, click Check on the connection. Without a connection you can still set up a device for a new hire. - For a new device, have its serial number from the order or the box, and publish the blueprint it should get.
Ask for a new hire #
Pick New hires in the side menu and choose the client, or open the client from Clients and pick its New hires tab. Then pick New hire.
Type their First name and Last name, and if you like their Job title, Department and Start date.
Under Microsoft 365, leave Make their account ticked. Check the Sign-in name (Enlist suggests first.last) and pick the Domain. Set the Country they work in: Microsoft needs it to give licenses.
Tick their Licenses (each shows how many are free) and Groups (Microsoft 365 groups and cloud security groups; distribution lists and groups synced from your own servers are managed elsewhere), and type their manager's sign-in name if they have one.
Under Device, pick A new device on its way and type its Serial number, Site and Blueprint, and where it ships to. Or pick One already enrolled and choose the device, or No device.
Pick Start and approve with your passkey.
What happens next #
- Enlist makes the account with a temporary password they must change when they first sign in, gives it the licenses, adds it to the groups and sets the manager. Each step is done once: if one fails, the ones already done aren't done again.
- A new device's serial number is pre-registered for them, so when it is installed with the client's install commands it lands at the right site with their name as Assigned to, and its blueprint starts. A device already enrolled is given to them at once.
- When the device is Ready, the request shows Ready and the New hire ready notification goes out.
The request #
Pick a new hire in the list to see each step and what to do:
- Show temporary password
- Read the password to pass to the new hire. It needs your passkey each time and is logged. Enlist wipes it 7 days after the account is made; after that, reset the password in the Microsoft 365 admin center.
- Shipping
- Type where the device goes, the carrier and the tracking number, then Mark shipped. For UPS, FedEx, USPS and DHL the client's status page links to the carrier's tracking page.
- Retry
- Shown when Microsoft 365 refused a step, with Microsoft's reason (for example, no licenses left). Fix it, then retry: it carries on from that step. If Microsoft is busy or doesn't answer, Enlist tries again by itself for about half an hour first.
- Cancel request
- Stops it: nothing more is done, the waiting serial number is removed and the password wiped. An account already made stays in Microsoft 365; remove it there if it isn't needed.
If a sign-in name already belongs to someone in the client's Microsoft 365, Enlist doesn't touch that account: the request stops and says so.
What the client sees #
The client's status page lists their new hires above their devices: each one's name, job title and start date, and whether the account, licenses, groups, device, shipping and setup are done. It never shows the password or Microsoft's error messages; a stopped step says Waiting on a technician.
Notifications #
Under Settings > Notifications a channel can choose newhire.failed (Microsoft 365 refused a step) and newhire.ready (the new hire is ready). A client's own channel gets only that client's.
Who can do what #
- Anyone who can see the client sees its new hires.
- Asking for one, retrying, cancelling, shipping and reading the password take Manage clients on the client; a device also takes Operate devices. Asking and reading the password each need a fresh passkey check.
- Everything is in the activity log (
newhire.created,newhire.account_created,newhire.password_viewed,newhire.cancelledand more).
Last updated 2026-11-19. Something wrong or missing? Email [email protected].