ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

TeamsTab.ReadWriteForTeam

Export JSON
Export CSV
Copy URL
Print
Delegated Read/Write User Scope

Allows a Teams app to read, install, upgrade, and uninstall all tabs to teams the signed-in user can access.

In short

TeamsTab.ReadWriteForTeam is a delegated permission in the Microsoft Graph API, grouped under the TeamsTab category. Allows a Teams app to read, install, upgrade, and uninstall all tabs to teams the signed-in user can access. It grants read and write access to resources. This delegated permission requires admin consent.

Permission data: September 15, 2026 at 3:10 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission Admin consent required

Allow the Teams app to manage all tabs in teams

Allows a Teams app to read, install, upgrade, and uninstall all tabs to teams the signed-in user can access.

User sees: Allows a Teams app to read, install, upgrade, and uninstall all tabs to teams you can access.
Permission ID: c975dd04-a06e-4fbb-9704-62daad77bb49

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 stringNullable Name of the tab.
id string Identifier that uniquely identifies a specific instance of a channel tab. Read-only.
webUrl stringNullable 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
GET /teams/{id}/channels/{id}/tabs
GET /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
POST /teams/{team-id}/channels/{channel-id}/tabs
PATCH /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
DELETE /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Exact Microsoft Learn match

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

Methods
GET /teams/{team-id}/channels/{channel-id}/tabs
GET /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
POST /teams/{id}/channels/{id}/tabs
PATCH /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
DELETE /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgTeamChannelTab /teams/{id}/channels/{id}/tabs
List tabs in channel
Get-MgTeamChannelTab /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Get tab in channel
New-MgTeamChannelTab /teams/{team-id}/channels/{channel-id}/tabs
Add tab to channel
Remove-MgTeamChannelTab /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Delete tab from channel
Update-MgTeamChannelTab /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
Update tab
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaTeamChannelTab /teams/{team-id}/channels/{channel-id}/tabs
List tabs in channel

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 Delegated permissions and search for TeamsTab.ReadWriteForTeam

4

Grant Admin Consent

This delegated permission requires admin consent.

Frequently asked questions

What is the TeamsTab.ReadWriteForTeam Microsoft Graph permission?

TeamsTab.ReadWriteForTeam is a delegated permission in the Microsoft Graph API, grouped under the TeamsTab category. Allows a Teams app to read, install, upgrade, and uninstall all tabs to teams the signed-in user can access. It grants read and write access to resources. This delegated permission requires admin consent. It is mapped to the Microsoft Graph teamstab resource type. 10 documented Microsoft Graph REST methods require it. 6 Microsoft Graph PowerShell commands are documented for it.

Is TeamsTab.ReadWriteForTeam an application or a delegated permission?

TeamsTab.ReadWriteForTeam is a delegated permission only. It grants access on behalf of a signed-in user and cannot be used for app-only access.

Does TeamsTab.ReadWriteForTeam require admin consent?

This delegated permission requires admin consent.

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

For TeamsTab.ReadWriteForTeam, the delegated (OAuth2 scope) ID is c975dd04-a06e-4fbb-9704-62daad77bb49. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.