Get started with Teams templates using Microsoft Graph
Note
Teams templates currently don't support creating private channels. Private channel creation isn't included in template definitions.
Teams templates are pre-built definitions of a team's structure designed around a business need or project. You can create your own template in the admin console. With Microsoft Graph, you use the pre-built templates . You can use Teams templates to quickly create rich collaboration spaces with channels for different topics and preinstall apps to pull in mission-critical content and services. Teams templates provide a predefined team structure that can help you easily create consistent teams across your organization.
In this article, we'll explain the properties that can be defined in templates, what base template types are, and how you can use a few samples requests to create a team from a template.
This article is for you if you're:
- Responsible for planning, deploying, and managing multiple teams across your organization
- A developer wanting to programmatically create a team with predefined channels and apps
Teams template capabilities
Most properties in a team are included and supported by templates. But there are a few properties and features that aren't currently supported. The following table provides a quick summary of what's included and what's not included in Teams templates.
Team properties supported by Teams templates | Team properties not yet supported by Teams templates |
---|---|
Base template type | Team membership |
Team name | Team picture |
Team description | Channel settings |
Team visibility (public or private) | Connectors |
Team settings (for example, member, guest, @ mentions) | Files and content |
Auto-favorite channel | |
Installed app | |
Pinned tabs |
Note
We'll be adding more template capabilities in future releases of Microsoft Teams, so check back for the most up-to-date information on supported properties.
What are base template types
Base template types are special templates that Microsoft created for specific industries. These base templates often contain proprietary apps that aren't available in the store. In addition, base templates often contain team properties that aren't yet supported individually in Teams templates. Learn how to use the team templates in Microsoft Graph.
Once a base template type is defined, you can extend or override these special templates with additional properties that you'd like to specify. Some base template types contain properties that can't be overridden.
By default the base template is set to Standard, which doesn't contain any additional proprietary apps or special properties. Below is the current list of base template types available.
Base template type | baseTemplateId | Properties that come with this base template |
---|---|---|
Standard | https://graph.microsoft.com/beta/ teamsTemplates('standard') |
No additional apps and properties |
Education - Class Team |
https://graph.microsoft.com/beta/ teamsTemplates('educationClass') |
Apps:
|
Education - Staff Team |
https://graph.microsoft.com/beta/ teamsTemplates('educationStaff') |
Apps:
|
Education - PLC team |
https://graph.microsoft.com/beta/ teamsTemplates('educationProfessionalLearningCommunity') |
Apps:
|
Retail - Store |
https://graph.microsoft.com/beta/ teamsTemplates('retailStore') |
Channels:
|
Retail - Manager collaboration |
https://graph.microsoft.com/beta/ teamsTemplates('retailManagerCollaboration') |
Channels:
|
Healthcare - Ward |
https://graph.microsoft.com/beta/ teamsTemplates('healthcareWard') |
Channels:
|
Healthcare - Hospital |
https://graph.microsoft.com/beta/ teamsTemplates('healthcareHospital') |
Channels:
|
Use the following templates to create teams in both the Teams client as well as Microsoft Graph.
Base template type | baseTemplateId | Properties that come with this base template |
---|---|---|
Adopt Office 365 | com.microsoft.teams.template. AdoptOffice365 |
Channels:
|
Manage a project | com.microsoft.teams.template. ManageAProject |
Channels:
|
Manage an event | com.microsoft.teams.template. ManageAnEvent |
Channels:
|
Onboard employees | com.microsoft.teams.template. OnboardEmployees |
Channels:
|
Organize help desk | com.microsoft.teams.template. OrganizeHelpDesk |
Channels:
|
Collaborate on patient care | healthcareWard |
Channels:
|
Collaborate on global crisis or event | com.microsoft.teams.template. CollaborateOnAGlobalCrisisOrEvent |
Channels:
|
Collaborate within a bank branch | com.microsoft.teams.template. CollaborateWithinABankBranch |
Channels:
|
Coordinate incident response | com.microsoft.teams.template. CoordinateIncidentResponse |
Channels:
|
Hospital | healthcareHospita l |
Channels:
|
Organize a store | retailStore |
Channels:
|
Quality and safety | com.microsoft.teams. template.QualitySafety |
Channels:
|
Retail - manager collaboration | retailManagerCollaboration |
Channels:
|
See Get started with Teams templates in the Admin center for more details.