# 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:

email

address_type

address_value

[email protected] [/cdn-cgi/l/email-protection]

 

teams

 

[email protected] [/cdn-cgi/l/email-protection]

 

[email protected] [/cdn-cgi/l/email-protection]

 

teams

 

[email protected] [/cdn-cgi/l/email-protection]

 

...

 

...

 

...

 

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








--------------------------------------------------------------------------------



--------------------------------------------------------------------------------