Microsoft 365 sign-in and directory synchronization serve different purposes. This guide sets up directory synchronization for the users and profile fields you select.
Connect the Microsoft 365 directory (Microsoft Entra ID, formerly Azure AD) to add users within the selected sync scope and update mapped profile fields when they change in Microsoft 365. Review the scope before starting the first sync.
Deleting a user from Microsoft 365 does not automatically remove their Yeeflow account. Review that account separately in Yeeflow user management. To revoke access, follow the steps to deactivate the Yeeflow user.
Use a Yeeflow system administrator account and a Microsoft 365 administrator who is authorized to approve the requested directory access.
Before you start
Before you start, here are some things to know before this process.
You need to be an administrator in Microsoft 365 directory to connect it.
You need to understand which users or groups in Microsoft 365 directory should be Yeeflow users.
You need to decide which information in Microsoft 365 directory should be updated in Yeeflow.
You need to add or update the user fields of Yeeflow which will sync from Microsoft 365.
Set up the sync service
Firstly, login to Yeeflow with the system admin account, then go to the Admin center. From the left navigation panel click to expand the "User management", and click "User sync":
If you haven't configure the Microsoft 365 user sync service yet, the status will show as "Not connected".
Click on this section to open the Microsoft 365 user sync configuration page.
Click the "Connect Microsoft 365" button to start the step by step configuration.
Firstly, the system requires to connect with your Microsoft 365 tenant with the Microsoft 365 administrator account. Click the "Connect" button to login with your Microsoft 365 account.
Sign in to the intended Microsoft 365 tenant and review the organization and requested permissions. Select Accept if you’re authorized to approve the request and it matches the planned sync.
After login, the next step is to choose which Microsoft 365 user properties you want to include when sync users to Yeeflow.
The left column shows the name of the user properties in Microsoft 365, while the right column show the mapped Yeeflow user properties (fields of Yeeflow users list). By default, the UPN from Microsoft 365 is automatically mapped with Yeeflow login account.
Select + Add field to map another attribute. For example, choose DisplayName on the Microsoft 365 side and User Name on the Yeeflow side, then select OK.
Please refer to below [Configuring Parameters] for directory mapping.
Configuring Parameters
Use the table to compare the Microsoft 365 source property with its Yeeflow destination and check any mapping rules.
Grid in AAD | Name in AAD | Name in Office 365 | Name in Yeeflow | ID(Yeeflow) | Field Type | Remarks(Yeeflow) |
Identity | userPrincipalName | UPN (userPrincipalName) | Login Account (SPAccount) | Login Account | String | ReadOnly and defaulted; |
Identity | Name | DisplayName (displayName) | User Name (Name) | Name_CN | String | Shown as an added mapping in the earlier wizard. Check the current mapping controls. |
Identity | User name | Email (mail) | Email(Email) | String | Customizable | |
Identity | Last name | Surname (surname) |
|
| String | New and Customizable |
Identity | First name | GivenName (givenName) |
|
| String | New and Customizable |
Identity | User type | UserType (userType) |
|
| String | New and Customizable |
Summary | Image | Photo (special_photo) | Profile Picture (Photo) | Profile Picture | Image | Customizable |
Job info | Job title | JobTitle (jobTitle) | Job Title (JobTitle) | JobTitle | String | Customizable |
Job info | Manager | LineManagers (special_lineManager) | Line Manager (LineManager) | Line Manager | User | Customizable; |
Job info | Department | Department (special_department) | Department (DepartmentID) | Department | String | Create a new one when first syncing |
Contact info | Country or region | Country (country) |
|
| String | New and Customizable |
Contact info | Office | OfficeLocation (officeLocation) |
|
| String | New and Customizable |
Contact info | City | City (city) |
|
| String | New and Customizable |
Contact info | Mobile phone | mobilePhone (mobilePhone) | Mobile No. (Mobile) | Mobile | String | Customizable |
Contact info | ZIP or postal code | PostalCode (postalCode) |
|
| String | New and Customizable |
|
| CompanyName (companyName) |
|
| String | New and Customizable |
|
| EmployeeId (employeeId) | Employee No.(EmployeeNo) | EmployeeNo | String | Customizable |
|
| FaxNumber (faxNumber) |
|
| String | New and Customizable |
After the mapping of selected fields are set, click the "Continue" button to jump to the next step.
Choose Sync all users or Specific groups. For example, use Specific groups to limit synchronization to members of the Sales Team, Designers, Engineering, and Marketing groups.
You can find the available user groups from your Microsoft 365 admin center.
Click "Continue" and click the "Start syncing users" button on the next step to complete the configuration.
The service page shows Job Running while the job is in progress. After it finishes, select Manage users and check that an expected member appears with the intended login account and a correctly mapped field. If a member is missing, check the sync status, scope, and directory group membership.
Manage the sync service
After your configuration, you may need to know more about how to managing this services.
Please go to Monitoring and Managing User Sync Services . You may run a manual sync, edit the services or stop it.


