Before you start
- Before you start: turn on MFA in Seven21. Owners and Admins need an authenticator app before Directories Sync will accept a connect. Open Account (avatar menu) or /app/mfa and finish setup (including saving recovery codes).
- Who: Seven21 Owner or Admin, plus someone who can register apps and grant admin consent in Microsoft Entra ID (often Global Administrator or Cloud Application Administrator).
- Time: About 15 to 25 minutes the first time.
- Seven21 will read: Directory users, groups, and last sign-in when AuditLog.Read.All and your Microsoft plan allow it.
- Access: read-only for directory sync. Seven21 does not remove people in the provider admin console.
Import employees with an Entra app registration and application permissions.
Turn on MFA in Seven21
- Owners and Admins need an authenticator app before Directories Sync will accept a connect.
- Open Account (avatar menu) or /app/mfa, finish setup, and save recovery codes.
Register an Entra application
- Sign in to the Microsoft Entra admin center for your company tenant.
- Go to Entra ID, then App registrations, then New registration.
- Enter a Name (for example, Seven21 directory). Under Supported account types, choose Accounts in this organizational directory only (single tenant). Click Register.
- On Overview, copy Application (client) ID and Directory (tenant) ID.
Add application permissions and grant admin consent
- Under Manage, open API permissions, then Add a permission, then Microsoft Graph, then Application permissions.
- Add the required permissions below, then Add permissions.
- Still on API permissions, click Grant admin consent for your tenant and confirm. Status should show Granted for your tenant on each permission.
- Under Manage, open Certificates & secrets, then New client secret. Add a description, choose an expiry, click Add. Copy the Value immediately (Entra shows it only once).
Microsoft Graph application permissions
User.Read.All
Group.Read.All
AuditLog.Read.AllOptional later: For account provisioning from Seven21, also add User.ReadWrite.All (Application), grant admin consent again, then reconnect.
Connect in Seven21
- Open Directories Sync in the Admin group of the left sidebar.
- On the Microsoft 365 card, click Connect (or Manage if reconnecting).
- Paste Tenant ID (Directory (tenant) ID), Client ID (Application (client) ID), and Client secret (the secret Value).
- Click Test and connect. On success, Seven21 opens Import preview. Nothing is saved to People until you Import.
Permissions checklist
- User.Read.All: Directory import
- Group.Read.All
- AuditLog.Read.All: Sign-in activity. Connect still succeeds without usable sign-in data.
- User.ReadWrite.All (optional later): Account provisioning only. Grant admin consent again if you enable provisioning.
Confirm it worked
Connection saved. Import preview lists people Seven21 can read. After Import, employees appear under People. Use Sync now anytime; Seven21 also runs a daily sync.
Troubleshooting
- Test and connect mentions User.Read.All: Grant admin consent for application permissions on this tenant, not only delegated permissions.
- Wrong tenant: Overview Directory (tenant) ID must match the tenant where you granted consent.
- Secret rejected: Use the secret Value, not Secret ID. Create a new client secret if the value was lost, then Update credentials.
- People import but no sign-in dates: Grant AuditLog.Read.All as an application permission, click Grant admin consent, and confirm the tenant has Entra ID P1 or P2. Then Sync now. People and Directories Sync show the specific cause when sign-in tracking fails.
Signed in? Open this guide in Help Center · Contact support
