Embed an app in Microsoft Teams

As an admin, you can share apps created in Power Apps to users in your tenant through Microsoft Teams. Upload the apps so they show up for all teams in your tenant under the All tabs section.

Individuals can share an app they've created in Power Apps in a Team they are a member of by following these instructions.

Note

Team custom app policies must be set to allow uploading custom apps. Check out custom app settings.

Prerequisites

Locate your app's GUID

Find and make note of your app's GUID to use in a later step.

  1. Sign in to https://make.powerapps.com, and then select Apps in the menu.

    Show list of apps

  2. Select More Commands (...) for the app you want to share in Teams, and then select Details.

    App details

  3. Record the App ID for later use.

    App details

Install App Studio

You can skip these steps if App Studio is already installed.

  1. In Teams, select Apps in the lower-left of the Teams menu (Apps icon).

  2. Search for "App Studio" in the search box and then select it.

    App Studio

  3. Select Install.

    Install App Studio

  4. Select Open for the App feature.

    Open App Studio

Create a Teams app

  1. In Teams, open App Studio.

    Open App Studio

  2. Select the Manifest editor tab, and then select Create a new app under Welcome.

    Create new app

  3. Fill in information about your app in the App Details page. For the App ID GUID, you should use your app's ID GUID you recorded above. This will avoid duplication of Teams apps for a particular app.

    Fill in information

    Fields Description
    App names
    Short name Required. The short display name for the app. 30 character limit.
    Long name The full name of the app, used if the full app name exceeds 30 characters.
    Identification
    App ID Required. The unique Microsoft-generated identifier for this app.
    Package Name Required. A unique identifier for this app in reverse domain notation; for example, com.example.myapp.
    Version Required. The version of the specific app. If you update something in your manifest, the version must be incremented as well.
    Descriptions
    Short description Required. A short description of your app experience, used when space is limited. 80 character limit.
    Long description Required. The full description of your app.
    Developer information
    Name Required. The display name for the company or developer.
    Website Required. The https:// URL to the website for your app via powerapps.com. When someone clicks to install and sees the About page, it should link to the web version of your app.
    App URLs These links will show up in the About page along with the website URL.
    Privacy statement Required. The https:// URL to the developer's privacy policy. Example.
    Terms of use Required. The https:// URL to the developer's terms of use. Example.
    Branding
    Full color A relative file path to a full color 192x192 PNG icon.
    Transparent outline A relative file path to a transparent 32x32 PNG outline icon.
    Accent color A color to use in conjunction with and as a background for your outline icons.

For more information, see Manifest Editor and Manifest schema.

  1. Scroll down to the Branding section and add your logos and the accent color desired for your app. These are the logos that will appear for your app in Teams.

    Branding and Tabs

  2. Under Capabilities, select Tabs.

Add a Team tab (Steps 6 and 7) or a Personal tab (Steps 8 and 9)

  1. Under Team tab select Add.

    Team tab Add

  2. Add your app's configuration URL in the "Configuration URL" input field, using the following format: https://apps.powerapps.com/play/<your app ID>?source=teamstab&locale={locale}&channelId={channelId}&channelType=&{channelType}&chatId=${chatId}&groupId={groupId}&hostClientType={hostClientType}&isFullScreen={isFullScreen}&subEntityID={subEntityID}&teamId={teamId}&teamType={teamType}&theme={theme}&userTeamRole={userTeamRole}

    Replace <App ID> with the App ID GUID you recorded above.

    Select the scope for your app to appear in. Ensure Can update configuration is checked, select Save, and then skip to Step 10.

    Configuration URL

--OR--

  1. To configure the Teams manifest, under Add a personal tab select Add.

    Team tab Add

  2. Fill in the following fields, and then select Save.

    Name: your app name
    Entity ID: your app ID
    Content URL: https://apps.powerapps.com/play/<your app ID>?source=teamstab&locale={locale}&channelId={channelId}&channelType=&{channelType}&chatId=${chatId}&groupId={groupId}&hostClientType={hostClientType}&isFullScreen={isFullScreen}&subEntityID={subEntityID}&teamId={teamId}&teamType={teamType}&theme={theme}&userTeamRole={userTeamRole}
    Website URL: https://apps.powerapps.com/play/<your app ID>?source=teamsopenwebsite&locale={locale}&channelId={channelId}&channelType=&{channelType}&chatId=${chatId}&groupId={groupId}&hostClientType={hostClientType}&isFullScreen={isFullScreen}&subEntityID={subEntityID}&teamId={teamId}&teamType={teamType}&theme={theme}&userTeamRole={userTeamRole}

    Configuration URL

Add the app to all teams in your tenant

  1. Under Finish, select Valid domains. Add apps.powerapps.com and apps.preview.powerapps.com as valid domains for the Teams application.

    Add valid domains

  2. To set device permissions for your app, under Device permissions select Set up.

    Device permissions

  3. Under Finish, select Test and distribute, and then select Download.

    Download app package

  4. Go to Store > Upload a custom app > Upload for [your tenant name].

    Upload for tenant

  5. Locate your app file and select it. Then, navigate to your team and select +.

    Add app

  6. You app will appear as a tile under All Tabs. Search for your app, select it, and then select Save.

    Add app as tab

The app now appears as a tab for all teams in your tenant.

App as tab