Sync Teams users

This article provides a 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 , Group.Read.All and GroupMember.Read.AllGraph API application permissions. If this permission is not an option, please skip to the section at the bottom of this article titled "Fallback Option: Manually Add User Teams Address".

There are two options to enabling User Sync based on the Teams Admin having an Arist Admin account or not:

1. If the Microsoft Teams Admin has an Arist Admin account:

   1. Navigate 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. In the Synchronize users section, there are two options. Note: Please verify with your organization's stakeholders before proceeding.

      1. Sync all Teams users OR

      2. Select specific groups to synchronize

2. If the Teams Admin does not have an Arist Admin account:

   1. As a Teams administrator, provide MS Graph API access for Arist to sync users by authorizing through the URL below (Replace <your_teams_tenant_id> with your Teams Tenant ID). Note: Depending on the permissions configured for your Teams organization you may need a Global Administrator to perform this step.

      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. After granting permissions through this link, have your Arist Technical Solutions Engineer verify that the manual authorization was successful.

   3. Additionally, please advise your Arist Technical Solutions Engineer whether you would like to sync all Teams users or if you would like to specify a group(s).

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 above, 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: