Microsoft Profile Image Sync
Learn how to automatically sync your Entra users profile images from Microsoft to your Maptician environment.
Contact Us
If you still have questions or prefer to get help directly, please reach out to your technical contact.
Table of Contents
⚠️ IMPORTANT
Maptician's External Calendar Sync requires a working Microsoft Graph API connection in Maptician. If you do not have a Graph API connection set up yet, follow the full setup first: Microsoft Graph API Configuration Guide.
Before You Begin
You will need the following:
- Access to your Microsoft Entra (formerly Azure AD) tenant with the ability to add and grant new API permissions.
- An active Maptician Account Admin user with access to your environment. This requirement applies only if you are configuring the integration yourself without Maptician assistance.
Configure Graph API Permissions for Profile Image Sync
ℹ️ NOTE
For additional details on Graph API permissions, refer to Microsoft's Graph permissions reference article.
From the Microsoft Entra ID home screen:
- In the left navigation menu, under Manage, select App registrations.
- In the App registrations list, find and select your existing app (usually named “Maptician Graph API” or similar).
- Once in the app, go to API permissions in the left menu.
- Click Add a permission.
- Select Microsoft Graph.
- Choose Application permissions.
-
Add the following permission:
User.Read.All: Allows the app to read user profiles without a signed in user.
- Click Add permissions.
- After the permission has been added, you will want to click Grant admin consent for [Your Organization] and then confirm it.
Enable Profile Image Sync in Maptician
- As an Account Admin, click the settings button (gear icon) in the top-right corner of the screen.
- Go to Environment > Sync Profile Images.
- Select the Enable Microsoft Profile Image Sync checkbox.
- Click the Save Changes button.
ℹ️ NOTE
Once your profile image sync has been established, the sync with Entra will take place daily at 1:00 AM US/Eastern.
Confirm the Graph API connection works in Maptician
Click the Check Connection button to validate your environment's connection to Entra ID, and the API permissions are configured correctly on the Graph API. If your Graph API permissions have just been configured, it may take up to 30 minutes until this connection is successful.
