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

TeamsTab.ReadWriteForChat

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

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

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission Admin consent required

Allow the Teams app to manage all tabs in chats

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

User sees: Allows a Teams app to read, install, upgrade, and uninstall all tabs in chats you can access.
Permission ID: ee928332-e9c2-4747-b4a0-f8c164b68de6

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 /chats/{chat-id}/tabs
GET /chats/{chat-id}/tabs/{tab-id}
POST /chats/{chat-id}/tabs
PATCH /chats/{chat-id}/tabs/{tab-id}
DELETE /chats/{chat-id}/tabs/{tab-id}
Exact Microsoft Learn match

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

Methods
GET /chats/{chat-id}/tabs
GET /chats/{chat-id}/tabs/{tab-id}
POST /chats/{chat-id}/tabs
PATCH /chats/{chat-id}/tabs/{tab-id}
DELETE /chats/{chat-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-MgChatTab /chats/{chat-id}/tabs
List tabs in chat
Get-MgChatTab /chats/{chat-id}/tabs/{tab-id}
Get tab in chat
New-MgChatTab /chats/{chat-id}/tabs
Add tab to chat
Remove-MgChatTab /chats/{chat-id}/tabs/{tab-id}
Delete tab from chat
Update-MgChatTab /chats/{chat-id}/tabs/{tab-id}
Update tab in chat
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaChatTab /chats/{chat-id}/tabs
List tabs in chat
Get-MgBetaChatTab /chats/{chat-id}/tabs/{tab-id}
Get tab in chat
New-MgBetaChatTab /chats/{chat-id}/tabs
Add tab to chat
Remove-MgBetaChatTab /chats/{chat-id}/tabs/{tab-id}
Delete tab from chat
Update-MgBetaChatTab /chats/{chat-id}/tabs/{tab-id}
Update tab in chat

Code Examples

C# / .NET SDK
Add tab to chat
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.Chats["{chat-id}"].Tabs.PostAsync(requestBody);
JavaScript
Add tab to chat
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('/chats/19:[email protected]/tabs')
	.post(teamsTab);
PowerShell
Add tab to chat
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-MgChatTab -ChatId $chatId -BodyParameter $params
Python
Add tab to chat
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.chats.by_chat_id('chat-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.ReadWriteForChat

4

Grant Admin Consent

This delegated permission requires admin consent.