How to deploy CreateTeam App into Teams

Create Team is provided as an Microsoft Teams App which needs to be uploaded to your organisation’s Apps section within Microsoft Teams.

NOTE: Some of the steps below require making changes to your Microsoft Online Tenant which can sometimes take a few hours to take effect

For the App to be able to create teams in the target Teams Tenant, it is a requirement that a Office 365 Global Admin of that tenant grants admin consent.

  1. This is achieved by clicking on the following link and logging in with a Global Administrator account, this will consent to the AAD APP 1 permisions below (for the API). Note AAD App 2 below (for the client) does not require admin consent.

    Provide Admin Consent

  2. These are the permissions that will be required

    #### AAD App 1 (for the API) : Application Permisions Directory.ReadWrite.All Read and write directory data - Allows the app to read and write data in your organization’s directory, such as users, and groups, without a signed-in user. Does not allow user or group deletion.

    Groups.ReadWrite.All Read and write all groups - Allows the app to create groups, read all group properties and memberships, update group properties and memberships, and delete groups. Also allows the app to read and write group calendar and conversations. All of these operations can be performed by the app without a signed-in user.

    #### AAD App 2 (for the client) : Delegated Permisions (no consent required) openid Sign in and read user profile - Allows users to sign-in to the app, and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users.

  3. The Admin Consent for AAD App 1 (for the API) that you just consented to, will be visible within the Enterprise Applications section of Azure AD



Click here to download the CreateTeam manifest file

    1. From Microsoft Teams go to the Apps section


  1. Then select Upload for [YOUR ORGANISATION NAME]


  2. Then select the App package provided by Modality Systems as a zip file


  3. The App should then appear within your companies Apps section


NOTE: To update an App that has already been installed, navigate to the App within your companies Apps section then hover your mouse pointer over the app, click on the … in the top right corner and click Update


Allow App to be installed within Microsoft Teams

Now that the App has been added to your Microsoft Teams Tenant, your Global policy may need to be adjusted to allow it to be installed by users.

  1. From the Microsoft Teams Admin Center, under Teams apps click Permission policies


  2. Click on Global (Org-wide default) (or whatever policy is applied to your organisation)


  3. Make sure the Tenant apps policy is set to Allow all apps


NOTE: You could also specify a list of allowed apps here

Pin App within Microsoft Teams

To improve the end user experience it is recommended to pin the App to the main Microsoft Teams list of Apps

  1. From the Microsoft Teams Admin Center, under Teams apps click Setup policies


  2. Either edit Global (Org-wide default) or create a new policy and give it a name


  3. Click Add apps, select Permissions policy from previous step, search for TG and click Add


  4. Click Save


If you created a new Setup policy in step 2 then you will need to assign users to the policy

  1. From the Microsoft Teams Admin Center, under Teams apps click Setup policies, click on the tick next to the required policy name


  2. Click Manage users and add the required users


Further information about managing app setup policies in Microsoft Teams is available:

Manage app setup policies in Microsoft Teams

NOTE A user can only be assigned to 1 app settings policy so this will remove them from the policy that they are currenlty assigned too

When a user first launches the App from within Microsoft Team, they are required to provide consent for their details to be accessed by the App


Changing default settings

This application looks at your default tenant settings to determine the default value of certain fields. To change your default tenant settings read the following guide.

The following fields look at tenant default values

  1. External Checkbox looks at AllowToAddGuests value