Entra ID
Connect TriNet to Entra ID
Turn TriNet hires, changes and departures into account updates in Entra ID. Follow the setup steps, preview changes with a dry run, then go live.
TriNet record
08:02:14
Amara Nwosu
4160
- Business Title
- Software Engineer
- Department
- Engineering
- Work Location
- Austin
- Supervisor
- D. Okafor
- Hire Date
- Nov 10, 2026
- Employment Status
- Active
Entra ID
eng-austin
- accountEngineering (administrative unit)
- userPrincipalNameamara.nwosu@northwind.com
- mailamara.nwosu@northwind.com
- jobTitleSoftware Engineer
- managerD. Okafor
- memberOfEng-All
- memberOfLicense-M365-E3
2.3s
- TriNet fields mapped
- 13
- Steps to go live
- 9
- Employee records stored in our cloud
- 0
Joiners, movers and leavers
How TriNet updates Entra ID
HR updates TriNet. ezOnboard updates accounts based on your rules.
Joiner
An account before day one
TriNet makes a new hire available through its API on the hire date or an early access date you set.
- Account created in the tenant, disabled until the start date
- Name, email, title, department, office and manager set from TriNet
- Account added to its administrative unit and groups, with group-based licenses assigned
- Account enabled on the start date, with a Temporary Access Pass for first sign-in
Mover
Access for the new role
A business title, department, work location or supervisor changes in the person’s TriNet employment record.
- Title, department, office and manager updated
- Account moved to the administrative unit your rules specify
- Groups and group-based licenses updated to match the new role
Leaver
Offboarding on schedule
TriNet reports a termination and its date after processing the final check.
- Account disabled on the termination date, never deleted
- Sign-in sessions revoked
- Direct licenses recovered and account removed from managed groups
Before you start
What to have ready
Work with a TriNet admin and a directory admin to complete the setup.
- In TriNet
- A TriNet company administrator to assign Integration Administrator to the person setting up the API
- A work email or employee ID for each person in TriNet to match them to their account
- In Entra ID
- A server running Windows Server 2019 or later; no domain join required
- A Global Administrator to grant consent to the ezOnboard application
- Outbound HTTPS to the HR system, ezOnboard, graph.microsoft.com and login.microsoftonline.com
- Administrative units and groups for ezOnboard to manage, and Temporary Access Pass enabled in your authentication methods policy
Step by step
Set up TriNet with Entra ID
Start in TriNet and on your server. Then finish in the ezOnboard portal with our implementation team.
01
TriNet
Grant the Integration Administrator role
Admin • Manager → Employees → Permissions
An Integration Administrator sets up the TriNet API and generates its credentials. The credentials belong to the company and keep working if that administrator leaves.
Sign in as a company administrator. Open Employees → Permissions, find the admin who will connect ezOnboard and assign Integration Administrator. No other role is needed. Save the change.
Permissions. Assign Integration Administrator only.
02
TriNet
Connect the TriNet API
Admin • Manager → Marketplace → TriNet API → Set up Integration
Sign in as the Integration Administrator. In Marketplace, find TriNet API and choose Set up Integration. Older accounts use Integration Center → Get Started. Select ezOnboard and review its read access. If it isn’t listed, ask your TriNet representative to add a custom integration.
Choose Accept. Copy the Company ID, Client ID and Client Secret to a secure location before choosing OK. They are shown only once. You’ll need all three in step 5. To revoke access later, choose Disconnect under My Connected Apps.
API credentials. Copy all three before choosing OK. They’re shown only once.
03
Your server
Install the ezOnboard agent
The agent runs as a Windows service on your server with Windows Server 2019 or later. No domain join is required. It connects to TriNet, ezOnboard and Microsoft Graph over outbound HTTPS. No inbound firewall rules are needed.
Download the signed MSI and enrollment bundle from the portal. Save the install code. The portal shows it only once. Run the MSI and enter the code. The agent uses a local virtual account by default, with no password to manage. The installer checks outbound access and the clock before making changes. Domain and LDAP checks show “not needed”.
Installer screen with the setup requirements.
04
ezOnboard portal and Microsoft
Connect your tenant and grant admin consent
Add a Microsoft 365 connection in the portal. Choose the Directory and Licenses capabilities, then continue to Microsoft. Sign in as a Global Administrator and grant consent. The portal shows which capabilities have access. You can grant missing permissions later.
ezOnboard uses application permissions, not an administrator account or password. Revoke consent in Entra ID to remove its access. Each tenant connects to one organization.
- Directory: manage users, managers, group memberships and administrative units
- Licenses: read subscriptions, assign licenses and recover unused licenses
- Sign-in: revoke sessions for leavers and issue a Temporary Access Pass to new hires
Connection page showing which capabilities have access.
05
ezOnboard portal
Add TriNet as an HR source
In the portal, add TriNet as an HR source using the Company ID, client ID and client secret. Your credentials are encrypted with your organization’s key and sent to your agent. The agent reads TriNet from your network. Nobody at ezOnboard can read the credentials.
Choose a field to match people across both systems, usually work email or employee ID. The agent checks TriNet every five minutes and catches up on any missed changes.
HR source. Your agent uses these credentials to read TriNet.
06
ezOnboard portal
Map TriNet fields to Entra ID attributes
Choose which TriNet fields update each directory attribute. Start with the defaults below, add custom fields or combine values. For example, build a display name from first and last names, format a job title or look up an office address by site.
Blank TriNet fields leave directory values unchanged unless you configure the mapping to clear them.
Field mapping. See the full list of defaults below.
07
ezOnboard portal
Set rules for accounts, administrative units and groups
Rules define who gets an account, which administrative unit it belongs to, how it’s named and which groups it joins. They also control offboarding. Use TriNet fields, such as department and site, to make those choices.
Our implementation team helps you write the rules. With approvals enabled, your team must approve each rule change before the agent uses it.
Rules page with the placement rule open.
08
ezOnboard portal
Preview changes with a dry run
Run a dry run for your whole workforce. The agent matches TriNet records to existing accounts by employee ID, then work email, and previews changes without applying them. If two accounts match one person, that action stops for review.
Review the planned changes and the rules behind them in the portal. Adjust your rules and repeat the dry run until the results match your expectations.
Dry run. No changes are applied while dry run is on.
09
ezOnboard portal
Go live
Turn off dry run to apply changes. If a run would disable or move more accounts than your safety limits allow, it stops and alerts your team before making changes. We review the first runs with you.
HR continues working in TriNet. Your rules handle new accounts, updates and offboarding on schedule. Get alerts by email, in the portal or by webhook when a run stops, the HR feed stops updating or the agent stops reporting. An inactive feed never triggers offboarding.
Reports with account activity, tickets avoided and agent uptime.
Field mapping
TriNet fields and Entra ID attributes
Start with these defaults and adjust any mapping. Dates and lifecycle status control when accounts are created, enabled or disabled.
| TriNet field | Entra ID attribute | How it’s used |
|---|---|---|
| First NamePersonal | givenName | Sets the first name at account creation and keeps it up to date. |
| Last NamePersonal | surname | Keeps the last name up to date. Also updates the logon name if your naming rule uses it. |
| Preferred NamePersonal | displayName | Uses the preferred name for the display name and email. Uses the first name if blank. |
| Work EmailContact | mail, userPrincipalName | Sets the email address and sign-in name. A mail rule can also generate them from the person’s name. |
| Employee IDEmployment | employeeId | Added to new accounts and used first to match existing accounts. |
| Business TitleEmployment | jobTitle | Keeps the job title up to date and sets groups based on your rules. |
| DepartmentEmployment | department | Keeps the department up to date. Rules can use it to choose account placement and groups. |
| Work LocationEmployment | officeLocation | Keeps the office up to date. A lookup table can also fill in the street, city and country. |
| SupervisorEmployment | manager | Links to the manager’s account to keep approvals and org charts in sync with TriNet. |
| Hire DateEmployment | accountEnabled | Sets when the account is created and enabled. You choose how many days before the hire date to create it. |
| Employment StatusEmployment | accountEnabled | Active keeps the account enabled. Terminated disables it when no other record keeps the person active. |
| Employee TypeEmployment | accountEnabled | Rules can use Full-Time, Part-Time or Temporary to choose groups and licenses. |
| Termination DateEmployment | accountEnabled | Sets the date for disabling the account and starting offboarding. Your rules set the time. |
Frequently asked questions
- Does ezOnboard write to TriNet?
- No. ezOnboard’s TriNet credentials have read-only access. They can’t change data in TriNet. Make any corrections in TriNet.
- Which TriNet permissions does the integration need?
- An Integration Administrator grants read access to employee, department and location data. The API credentials belong to the company and don’t inherit a user’s permissions.
- Do we need TriNet’s Entra ID integration or SCIM?
- No. ezOnboard reads TriNet’s API and uses your rules to manage accounts in Active Directory or Entra ID. Its agent runs on your network and can also manage Exchange.
- Do we need a server for Entra ID?
- Yes. Use a Windows Server with outbound HTTPS to TriNet, ezOnboard and Microsoft Graph. No domain join or inbound firewall rules are required. The agent runs as a local virtual account by default and keeps employee data on your network. It doesn’t store tenant administrator credentials.
- What permissions does ezOnboard need in Entra ID?
- A Global Administrator grants consent to the ezOnboard application. Permissions are grouped by capability, such as managing users or assigning licenses. You can grant additional capabilities later. Revoke consent in Entra ID to remove access.
- How quickly does a TriNet change reach Entra ID?
- The agent checks TriNet every five minutes and usually applies changes within seconds of finding them. Scheduled changes follow your rules: accounts are created before the start date, enabled on that date and disabled on the termination date at the time you choose.
- How does TriNet trigger offboarding in Entra ID?
- On the termination date, the account is disabled and its sign-in sessions are revoked. Direct licenses are recovered. The account is removed from managed groups, releasing their licenses. The account is never deleted. Every step is recorded for audit.
- How do new hires sign in?
- With a Temporary Access Pass issued when their account is enabled on the start date. ezOnboard emails it to their manager or an address set by your rules. Enable Temporary Access Pass in your authentication methods policy and provide an Exchange Online mailbox to send from.
- Which guide should we use for a hybrid directory?
- Use the Active Directory guide if your accounts sync to Entra ID through Entra Connect. The agent updates on-premises accounts and manages licenses and mailboxes in the cloud. It won’t change cloud attributes owned by Entra Connect. This guide covers cloud-only accounts.
Get a demo
See TriNet connected to Entra ID
Get a demo for your TriNet and Entra ID setup. For questions, email sales@ezonboard.io.