Skip to main content

Add Member To Channel

Add a member to a channel. This operation is allowed only for channels with a membershipType value of private.

  • Least privileged Microsoft Graph permission to access the action via application: ChannelMember.ReadWrite.All.
  • Least privileged Microsoft Graph permission to access the action via OAuth: ChannelMember.ReadWrite.All.

More information about the higher privileged permissions can be found in the Microsoft Teams permissions documentation.

External Documentation

To learn more, visit the Microsoft Teams documentation.

Parameters

ParameterDescription
Channel IDThe ID of the channel.
MemberThe ID or email of the member to add to the channel.
RoleThe role for the member.
Team IDThe ID of the channel's team.

Example Output

{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('ece6f0a1-7ca4-498b-be79-edf6c8fc4d82')/channels('19%3A56eb04e133944cf69e603c5dac2d292e%40thread.skype')/members/microsoft.graph.aadUserConversationMember/$entity",
"@odata.type": "#microsoft.graph.aadUserConversationMember",
"id": "ZWUwZjVhZTItOGJjNi00YWU1LTg0NjYtN2RhZWViYmZhMDYyIyM3Mzc2MWYwNi0yYWM5LTQ2OWMtOWYxMC0yNzlhOGNjMjY3Zjk=",
"roles": [],
"displayName": "John Doe",
"userId": "8b081ef6-4792-4def-b2c9-c363a1bf41d5",
"email": null
}

Workflow Library Example

Add Member to Channel with Microsoft Teams and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop