ChannelMember.ReadWrite.All | Graph Permissions

Permission Details

Application Permission

Add and remove members from all channels

Add and remove members from all channels, without a signed-in user. Also allows changing a member's role, for example from owner to non-owner.

Permission ID: 35930dcf-aceb-4bd1-b99a-8ffed403c974

Delegated Permission

Add and remove members from channels

Add and remove members from channels, on behalf of the signed-in user. Also allows changing a member's role, for example from owner to non-owner.

Permission ID: 0c3e411a-ce45-4cd1-8f30-f99a3efa7b11

Properties

Microsoft Graph v1.0 endpoint-derived-docs

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

Property	Type	Description
`chatType`	`chatType`	Specifies the type of chat. The possible values are: group, oneOnOne, meeting, unknownFutureValue.
`createdDateTime`	`dateTimeOffset`Nullable	Date and time at which the chat was created. Read-only.
`id`	`String`	The chat's unique identifier. Read-only.
`isHiddenForAllMembers`	`Boolean`Nullable	Indicates whether the chat is hidden for all its members. Read-only.
`lastUpdatedDateTime`	`dateTimeOffset`Nullable	Date and time at which the chat was renamed or the list of members was last changed. Read-only.
`onlineMeetingInfo`	`teamworkOnlineMeetingInfo`	Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. Read-only.
`tenantId`	`String`Nullable	The identifier of the tenant in which the chat was created. Read-only.
`topic`	`String`Nullable	(Optional) Subject or topic for the chat. Only available for group chats.
`viewpoint`	`chatViewpoint`	Represents caller-specific information about the chat, such as the last message read date and time. This property is populated only when the request is made in a delegated context.
`webUrl`	`String`Nullable	The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only.
`installedApps`	`teamsAppInstallation collection`	A collection of all the apps in the chat. Nullable.
`lastMessagePreview`	`object`	Preview of the last message sent in the chat. Null if no messages were sent in the chat. Currently, only the list chats operation supports this property.
`members`	`conversationMember collection`	A collection of all the members in the chat. Nullable.
`messages`	`chatMessage collection`	A collection of all the messages in the chat. Nullable.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps for the chat.

Showing 15 of 17 properties.

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

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

JSON representation

{
  "createdDateTime": "dateTimeOffset",
  "chatType": "string",
  "id": "string (identifier)",  
  "isHiddenForAllMembers": "Boolean",
  "lastUpdatedDateTime": "dateTimeOffset",
  "onlineMeetingInfo": {
    "@odata.type": "microsoft.graph.teamworkOnlineMeetingInfo"
  },
  "tenantId": "string",
  "topic": "string",
  
  "viewpoint": {
    "@odata.type": "microsoft.graph.chatViewpoint"
  },
  "webUrl": "string",
}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

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

Relationship	Type	Description
`installedApps`	`teamsAppInstallation collection`	A collection of all the apps in the chat. Nullable.
`lastMessagePreview`	`chatMessageInfo`	Preview of the last message sent in the chat. Null if no messages were sent in the chat. Currently, only the list chats operation supports this property.
`members`	`conversationMember collection`	A collection of all the members in the chat. Nullable.
`messages`	`chatMessage collection`	A collection of all the messages in the chat. Nullable.
`permissionGrants`	`resourceSpecificPermissionGrant collection`	A collection of permissions granted to apps for the chat.
`pinnedMessages`	`pinnedChatMessageInfo collection`	A collection of all the pinned messages in the chat. Nullable.
`tabs`	`teamsTab collection`	A collection of all the tabs in the chat. Nullable.
`chatType`	`chatType`	Related chatType data exposed by this resource.
`operations`	`teamsAsyncOperation collection`	A collection of all the Teams async operations that ran or are running on the chat. Nullable.

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/{id}/members/{id}`
GET `/teams/{id}/channels/{id}/members/{id}`
GET `/teams/{team-id}/channels/{channel-id}/allMembers`
GET `/teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userId',tenantId='@tenantId',userPrincipalName='@userPrincipalName')`
GET `/teams/{team-id}/channels/{channel-id}/members`
GET `/teams/{team-id}/channels/{channel-id}/members/{membership-id}`
GET `/teams/{team-id}/channels/{channel-id}/sharedWithTeams`
GET `/teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}`
GET `/teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}/allowedMembers`
POST `/teams/{id}/channels/{id}/members`
POST `/teams/{team-id}/channels/{channel-id}/members`
PATCH `/teams/{id}/channels/{id}/members/{id}`
PATCH `/teams/{team-id}/channels/{channel-id}/members/{membership-id}`
DELETE `/teams/{id}/channels/{id}/members/{id}`
DELETE `/teams/{team-id}/channels/{channel-id}/members/{membership-id}`
DELETE `/teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-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}/allMembers`
GET `/teams/{team-id}/channels/{channel-id}/allMembers/{membership-id}`
GET `/teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userId',tenantId='@tenantId',userPrincipalName='@userPrincipalName')`
GET `/teams/{team-id}/channels/{channel-id}/members`
GET `/teams/{team-id}/channels/{channel-id}/members/{membership-id}`
GET `/teams/{team-id}/channels/{channel-id}/sharedWithTeams`
GET `/teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}`
GET `/teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}/allowedMembers`
POST `/teams/{team-id}/channels/{channel-id}/members`
PATCH `/teams/{team-id}/channels/{channel-id}/members/{membership-id}`
DELETE `/teams/{team-id}/channels/{channel-id}/members/{membership-id}`
DELETE `/teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}`

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgChatMember` /chats/{id}/members/{id} Get conversationMember
`Get-MgTeamChannelMember` /teams/{team-id}/channels/{channel-id}/allMembers List allMembers
`Get-MgTeamChannelSharedWithTeam` /teams/{team-id}/channels/{channel-id}/sharedWithTeams List sharedWithChannelTeamInfo
`Get-MgTeamChannelSharedWithTeam` /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id} Get sharedWithChannelTeamInfo
`Get-MgTeamChannelSharedWithTeamAllowedMember` /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}/allowedMembers List allowedMembers
`Invoke-MgHaveTeamChannel` /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userId',tenantId='@tenantId',userPrincipalName='@userPrincipalName') channel: doesUserHaveAccess
`Remove-MgTeamChannelSharedWithTeam` /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id} Delete sharedWithChannelTeamInfo

Exact Microsoft Learn PowerShell match

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

Commands
`Get-MgBetaTeamChannelMember` /teams/{team-id}/channels/{channel-id}/allMembers List allMembers
`Get-MgBetaTeamChannelMember` /teams/{team-id}/channels/{channel-id}/allMembers/{membership-id} Get member from channel allMembers collection
`Get-MgBetaTeamChannelSharedWithTeam` /teams/{team-id}/channels/{channel-id}/sharedWithTeams List sharedWithChannelTeamInfo
`Get-MgBetaTeamChannelSharedWithTeam` /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id} Get sharedWithChannelTeamInfo
`Get-MgBetaTeamChannelSharedWithTeamAllowedMember` /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id}/allowedMembers List allowedMembers
`Invoke-MgBetaHaveTeamChannel` /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userId',tenantId='@tenantId',userPrincipalName='@userPrincipalName') channel: doesUserHaveAccess
`Remove-MgBetaTeamChannelSharedWithTeam` /teams/{team-id}/channels/{channel-id}/sharedWithTeams/{shared-with-channel-team-info-id} Delete sharedWithChannelTeamInfo

Code Examples

C# / .NET SDK

Add conversationMember

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 AadUserConversationMember
{
	OdataType = "#microsoft.graph.aadUserConversationMember",
	Roles = new List<string>
	{
	},
	AdditionalData = new Dictionary<string, object>
	{
		{
			"[email protected]" , "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5"
		},
	},
};

// 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}"].Members.PostAsync(requestBody);

JavaScript

Add conversationMember

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const conversationMember = {
  '@odata.type': '#microsoft.graph.aadUserConversationMember',
  roles: [],
  '[email protected]': 'https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5'
};

await client.api('/teams/{id}/channels/{id}/members/')
	.post(conversationMember);

PowerShell

Delete sharedWithChannelTeamInfo

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Teams

Remove-MgTeamChannelSharedWithTeam -TeamId $teamId -ChannelId $channelId -SharedWithChannelTeamInfoId $sharedWithChannelTeamInfoId

Python

Add conversationMember

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.aad_user_conversation_member import AadUserConversationMember
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AadUserConversationMember(
	odata_type = "#microsoft.graph.aadUserConversationMember",
	roles = [
	],
	additional_data = {
			"user@odata_bind" : "https://graph.microsoft.com/v1.0/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5",
	}
)

result = await graph_client.teams.by_team_id('team-id').channels.by_channel_id('channel-id').members.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 ChannelMember.ReadWrite.All

4

Grant Admin Consent

Application permissions always require admin consent.