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.
- 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
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.
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.)
If you have a Teams account, verify if you can sideload apps in Teams:
- In the Teams client, select Apps.
- Look for an option to Upload a custom app.
Select here if you can't see the sideload option or don't have a Teams account.
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.)
- Go to the Microsoft 365 developer program.
- Select Join Now and follow the onscreen instructions.
- When you get to the welcome screen, select Set up E5 subscription.
- Set up your administrator account. Once you finish, you should see a screen like this.
- Log in to Teams using the administrator account you just set up.
- 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.)
Install ngrok if you plan to build a bot or messaging extension.
Install the latest version of Visual Studio Code. (Earlier versions might not work with the toolkit.)
In Visual Studio Code, select Extensions on the left Activity Bar and install the Microsoft Teams Toolkit.
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.
Once you set up your account and environment, you can start building.