Developer Portal for Teams

Developer Portal for Teams is the primary tool for configuring, distributing, and managing your Microsoft Teams apps. With Developer Portal, you can collaborate with colleagues on your app, set up runtime environments, and much more.

The screenshot is an example that shows the home page of Developer Portal for Teams.


  • Currently, Developer Portal is not available for Government Community Cloud (GCC)-High or Department of Defense (DOD) tenants.
  • However, you can use a regular tenant to build an app in Developer Portal, download the app, and upload the app using Microsoft Graph to a national cloud. For more information, see National cloud deployments.

Register an app

Developer Portal provides the following ways to register a Teams app:

Create and register a brand new app

Developer portal allows you to create a brand new app:

  1. Log into Developer Portal, select Apps from the left pane.

    The screenshot is an example that shows the Developer Portal for Teams home page.

  2. Select + New app.

    Create new from developer portal

  3. Enter app name and select Add.

    The screenshot shows how to create a brand new app in Developer Portal for Teams.

Now you've successfully created a brand new app and you can see all the basic information of the new app.

The screenshot is an example that shows the basic information of the app you created in the Developer Portal for Teams.

Import an existing app

Follow the steps to import and manage your existing app in Developer Portal:

  1. Select Apps from the left pane of the Developer Portal.

  2. Select Import App.

    The screenshot show how to import your existing app in Developer Portal for Teams to manage your apps.

  3. Select the app manifest file, and then select Open.


    You can receive an error message such as Provided add-in package was not understood. Ensure that the file being submitted is a valid Office add-in package, if there are nested folders or missing files in the app package folder.

  4. Select Import.

    • Developer Portal creates a unique app ID and locks the ID for your registered Teams app. You can’t edit or provide an ID of your choice, which prevents to have duplicate app IDs for multiple apps.
    • If you create an app using the Microsoft Teams Toolkit for Visual Studio Code, you can manage your app in Developer Portal.
    • You can import an existing app which you created on App Studio to Developer Portal. To import an already published app to Developer Portal, the app owner needs to raise a service request through admin portal to transfer the ownership over the app ID.

Next step

See also