Build your first Microsoft Teams app overview

In the get started lessons, you learn how to create basic Teams apps. Each tutorial walks through how to build a simple, real-world Teams app while introducing you to common tools, fundamental concepts, and more advanced features.

What you'll learn

Here's an idea of what you'll know after going through the lessons.

  • Get up and running quickly with the Teams Toolkit: The Microsoft Teams Toolkit for Visual Studio Code takes care of creating your app project and scaffolding so you can have a running app in minutes.
  • Configure your app with App Studio: Specify the capabilities and services your Teams app uses.
  • Scope your app's audience: Build a Teams app for personal use, collaboration, or both.
  • Get experience with Teams tools and SDKs: Customize your app with help from the Teams JavaScript client SDK. For example, change your app's color scheme to match the Teams theme. Also, learn about common tools for creating and managing bots.
  • Expand on your app: Throughout the lessons, you'll find related topics you're probably interested in (such as authentication and design guidelines).

Teams app fundamentals

Before you begin the tutorials, you should know the following about building apps for Teams.

Apps can have multiple capabilities and entry points

A Teams app is made up of one or more platform capabilities (how people use the app) and entry points (where people use the app).

Teams doesn't host your app

A Teams app includes the following important pieces:

  • The logic, data storage, and API calls that power your app. These services are not hosted by Teams and must be accessible via HTTPS.
  • The Teams client (web, desktop, or mobile) where people use your app.
  • Your app ID, which lets you configure your app with App Studio.

Get prerequisites

Verify you have the right account for building Teams apps and install some recommended development tools.

Set up your development account

You need a Teams account that allows custom app sideloading. (Your account may already provide this.)

  1. If you have a Teams account, verify if you can sideload apps in Teams:

    1. In the Teams client, select Apps.
    2. Look for an option to Upload a custom app.

    Illustration showing where in Teams you can upload a custom app.

    If you don't see the button, you don't have permission to upload custom apps in your org. You can get this feature by signing up for a free Microsoft 365 developer subscription.

Get your free Microsoft 365 developer subscription

You can get a free Teams test account that allows app sideloading by joining the Microsoft 365 developer program. (The registration process takes approximately two minutes.)

  1. Go to the Microsoft 365 developer program.
  2. Select Join Now and follow the onscreen instructions.
  3. When you get to the welcome screen, select Set up E5 subscription.
  4. Set up your administrator account. Once you finish, you should see a screen like this. Example of what you see after signing up for the Microsoft 365 developer program.
  5. Log in to Teams using the administrator account you just set up.
  6. Verify if you now have the Upload a custom app option.


If you still can't sideload apps, see enable custom Teams apps and turn on custom app uploading.

Install your development tools

You can build Teams apps with your preferred tools, but these lessons show how you can get started quickly with the Microsoft Teams Toolkit for Visual Studio Code.

Teams displays app content only through HTTPS connections. To debug certain types of apps locally, such as a bot, you'll learn how to use ngrok to set up a secure tunnel between Teams and your app. (Production Teams apps are hosted in the cloud.)

  1. Install Node.js.

  2. Install ngrok if you are building a bot or messaging extension and create a tunnel using ngrok.

  3. Install the latest version of Visual Studio Code. (Earlier versions might not work with the toolkit.)

  4. In Visual Studio Code, select Extensions on the left Activity Bar and install the Microsoft Teams Toolkit.

    Illustration showing where in Visual Studio Code you can install the Microsoft Teams Toolkit extension.

About the tutorials

You can start with any of the Teams get started lessons. If you're not sure where to go first, follow our beginner friendly path and build a "Hello, World!" app.

Skill tree showing learning paths for the Teams 'get started' lessons.

Next step

Once you set up your account and environment, you can start building.

Beginner friendly tutorial

Other tutorials