How to sync Teams users

This article shows a video walkthrough of how the Teams User Sync feature works. Below, there are more options provided for when the Teams Administrator doesn't have access to the Arist web user interface, as well as a fallback option for when the MS Graph API is not possible to use in your organization for any reason.

Recommended Option: Arist User Sync Feature

The Teams User sync feature will grant User.Read.All and Group.Read.All Graph API application permissions.

To sync Teams users through Arist (through Arist web UI):

1. As an Arist administrator, go to your Arist organization settings > choose Delivery Methods.

2. Under the Teams delivery method, you can enable syncing by clicking the enable toggle and logging in with your Teams email address. You must be an administrator in your Teams tenant.

3. You can now choose to sync all Teams users, or just some specific groups.

To sync Teams users through Arist (without Arist web UI access):

1. As a Teams administrator, provide MS Graph API access for Arist to sync users by authorizing through this URL:
   https://login.microsoftonline.com/<your_teams_tenant_id>/adminconsent?client_id=71658e0f-b3f0-4c4b-84b1-41d67c949a17&redirect_uri=https://arist.app/microsoft/auth/callback&state=teamsUserSync

2. If using the above URL manually, please contact your Technical Solutions Engineer to verify that the manual authorization was successful.

Once enabled, Arist will sync the appropriate users about once an hour. You will see these users synced into the Teams Tenant cohort:

Fallback Option: Manually Add User Teams Address

In case you are not able to use the Arist User Sync functionality, you can also manually upload your Teams addresses.

In the Arist app, this is available under "Cohorts" by looking for the automatically created Teams tenant cohort. When you select "Add learners", the upload screen appears:

Format your CSV like this for the manual upload of Microsoft Teams email addresses:

Arist will auto-map the columns for you like so: