.. _create-msteams-service-acc-azure:


Create MS Teams service account on Microsoft cloud 
----------------------------------------------------

This procedure creates the Microsoft Teams admin user service account for Automate in the Microsoft 
365 Admin Center, and assigns the *Teams Administrator* role. 

.. note:: 
   
   The PowerShell proxy server uses the Microsoft Teams service account to manage Microsoft Teams resource accounts.



.. rubric:: To create the MS Teams user service account

1. Use your MS account admin user to log in to the `Microsoft 365 Admin Center <https://admin.microsoft.com>`_.
2. Go to **Users > Active users**, then click **Add a user**.  
3. Fill out user details: 

   * Specify first name, last name, display name, and username (e.g. "voss-svc").
   * Choose a domain. You can choose any domain in the drop-down, including the default "\*.onmicrosoft.com" domain.
   * Create a password for the account. 
   * Clear the checkbox that requires the user to change their password when they first sign in. 

   .. note:: 
        
      * Make a note of the user name, domain name, and password you create. You'll need these details 
        when setting up the connection parameters in Automate. See :ref:`ms-tenant-setup`
      * There is no need to assign a license. 

   * Assign the user with the **Teams Administrator** role. 

     .. note:: 

        Starting in Q3 2024, Teams administrators must have user management permissions in Microsoft 365 
        to create resource accounts. If you wish to continue using Automate to create resource accounts, the 
        Service Account should be assigned "User Administrator", "Global Administrator", or custom roles that 
        include the "User Management" permission".

        For further details around Microsoft's changes with regard to resource accounts, see 
        `VOSS Automate 24.1 - Microsoft Customers, Upgrade Planning for App Registration <https://documentation.voss-solutions.com/release_24.1-PB1/html/VOSS-Automate-24.1-Microsoft-Customers-Upgrade-Planning-for-App-Registration.pdf>`_ 

4. Save your changes to create the user.

