TeamsTab.Create | Graph Permissions

Permission Details

Application Permission

Create tabs in Microsoft Teams.

Allows the app to create tabs in any team in Microsoft Teams, without a signed-in user. This does not grant the ability to read, modify or delete tabs after they are created, or give access to the content inside the tabs.

Permission ID: 49981c42-fd7b-4530-be03-e77b21aed25e

Delegated Permission

Create tabs in Microsoft Teams.

Allows the app to create tabs in any team in Microsoft Teams, on behalf of the signed-in user. This does not grant the ability to read, modify or delete tabs after they are created, or give access to the content inside the tabs.

Permission ID: a9ff19c2-f369-4a95-9a25-ba9d460efc8e

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`configuration`	`teamsTabConfiguration`	Container for custom settings applied to a tab. The tab is considered configured only once this property is set.
`displayName`	`string`Nullable	Name of the tab.
`id`	`string`	Identifier that uniquely identifies a specific instance of a channel tab. Read-only.
`webUrl`	`string`Nullable	Deep link URL of the tab instance. Read-only.
`teamsApp`	`object`	The application that is linked to the tab. This can't be changed after tab creation.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "id": "string",
  "displayName": "string",
  "webUrl": "string",
  "configuration": "teamsTabConfiguration"
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`teamsApp`	`teamsApp`	The application that is linked to the tab. This can't be changed after tab creation.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
POST `/chats/{chat-id}/tabs`
POST `/teams/{team-id}/channels/{channel-id}/tabs`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
POST `/chats/{chat-id}/tabs`
POST `/teams/{id}/channels/{id}/tabs`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`New-MgChatTab` /chats/{chat-id}/tabs Add tab to chat
`New-MgTeamChannelTab` /teams/{team-id}/channels/{channel-id}/tabs Add tab to channel

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`New-MgBetaChatTab` /chats/{chat-id}/tabs Add tab to chat

Code Examples

C# / .NET SDK

Add tab to channel

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new TeamsTab
{
	DisplayName = "My Contoso Tab",
	Configuration = new TeamsTabConfiguration
	{
		EntityId = "2DCA2E6C7A10415CAF6B8AB6661B3154",
		ContentUrl = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView",
		WebsiteUrl = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154",
		RemoveUrl = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/uninstallTab",
	},
	AdditionalData = new Dictionary<string, object>
	{
		{
			"[email protected]" , "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8"
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Channels["{channel-id}"].Tabs.PostAsync(requestBody);

JavaScript

Add tab to channel

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const teamsTab = {
  displayName: 'My Contoso Tab',
  '[email protected]': 'https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8',
  configuration: {
    entityId: '2DCA2E6C7A10415CAF6B8AB6661B3154',
    contentUrl: 'https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView',
    websiteUrl: 'https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154',
    removeUrl: 'https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/uninstallTab'
  }
};

await client.api('/teams/{id}/channels/{id}/tabs')
	.post(teamsTab);

PowerShell

Add tab to channel

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

$params = @{
	displayName = "My Contoso Tab"
	"[email protected]" = "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8"
	configuration = @{
		entityId = "2DCA2E6C7A10415CAF6B8AB6661B3154"
		contentUrl = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView"
		websiteUrl = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154"
		removeUrl = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/uninstallTab"
	}
}

New-MgTeamChannelTab -TeamId $teamId -ChannelId $channelId -BodyParameter $params

Python

Add tab to channel

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.teams_tab import TeamsTab
from msgraph.generated.models.teams_tab_configuration import TeamsTabConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TeamsTab(
	display_name = "My Contoso Tab",
	configuration = TeamsTabConfiguration(
		entity_id = "2DCA2E6C7A10415CAF6B8AB6661B3154",
		content_url = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/tabView",
		website_url = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154",
		remove_url = "https://www.contoso.com/Orders/2DCA2E6C7A10415CAF6B8AB6661B3154/uninstallTab",
	),
	additional_data = {
			"teams_app@odata_bind" : "https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8",
	}
)

result = await graph_client.teams.by_team_id('team-id').channels.by_channel_id('channel-id').tabs.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for TeamsTab.Create

4

Grant Admin Consent

Application permissions always require admin consent.

Frequently asked questions

What is the TeamsTab.Create Microsoft Graph permission?

TeamsTab.Create is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the TeamsTab category. Allows the app to create tabs in any team in Microsoft Teams, without a signed-in user. This does not grant the ability to read, modify or delete tabs after they are created, or give access to the content inside the tabs. It grants read-only access to resources. Application permissions always require admin consent. It is mapped to the Microsoft Graph teamstab resource type. 4 documented Microsoft Graph REST methods require it. 3 Microsoft Graph PowerShell commands are documented for it.

Is TeamsTab.Create an application or a delegated permission?

TeamsTab.Create is available as both an application permission (app-only access, no signed-in user) and a delegated permission (access on behalf of a signed-in user).

Does TeamsTab.Create require admin consent?

Application permissions always require admin consent.

What is the permission ID (GUID) for TeamsTab.Create?

For TeamsTab.Create, the application (app role) ID is 49981c42-fd7b-4530-be03-e77b21aed25e, and the delegated (OAuth2 scope) ID is a9ff19c2-f369-4a95-9a25-ba9d460efc8e. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.