channel resource type

Namespace: microsoft.graph

Teams are made up of channels, which are the conversations you have with your teammates. Each channel is dedicated to a specific topic, department, or project. Channels are where the work actually gets done - where text, audio, and video conversations open to the whole team happen, where files are shared, and where tabs are added.

Methods

Method	Return Type	Description
List channels	channel collection	Get the list of channels in a team.
List incoming channels	channel collection	Get the list of incoming channels (channels shared with a team).
List all channels	channel collection	Get the list of channels either in a team or shared with a team (incoming channels).
Create channel	channel	Create a new channel by including the display name and description.
Get channel	channel	Read properties and relationships of the channel.
Get primary channel	channel	The general channel for the team.
Update channel	channel	Update properties of the channel.
Delete channel	None	Delete a channel.
List channel messages	chatMessage	Get messages in a channel
Get all channel messages	channel collection	Get all messages from all channels that a user is a participant in.
Get all retained channel messages	chatMessage collection	Get all retained messages across all channels in a team.
Create channel message post	chatMessage	Send a message to a channel.
Create reply to channel message post	chatMessage	Reply to a message in a channel.
Get files folder	driveItem	Retrieves the details of the SharePoint folder where the files for the channel are stored.
List tabs	teamsTab	Lists tabs pinned to a channel.
List channel members	conversationMember collection	Get a list of members in a channel, including direct members of standard, private, and shared channels.
List all members	conversationMember collection	Get a list of all members in a channel.
Add channel member	conversationMember	Add a member to a channel. Only supported for channels with a membershipType of private or shared.
Get channel member	conversationMember collection	Get a member in a channel.
Archive channel	None	Archive a channel in a team.
Unarchive channel	None	Restore an archived channel in a team.
Update channel member's role	conversationMember	Update the properties of a member of the channel. Only supported for channels with a membershipType of private or shared.
Remove channel member	None	Delete a member from a channel. Only supported for channels with a membershipType of private or shared.
Start migration	channel	Start the migration of external messages by enabling migration mode in an existing channel.
Complete migration	channel	Complete migration on existing channels or new channels.
List tabs in channel	teamsTab	List tabs pinned to a channel.
Add tab to channel	teamsTab	Add (pin) a tab to a channel.
Get tab in channel	teamsTab	Get a specific tab pinned to a channel.
Update tab in channel	teamsTab	Updates the properties of a tab in a channel.
Remove tab from channel	None	Remove (unpin) a tab from a channel.
List apps in channel	teamsApp collection	Get a list of the enabled apps in the specified channel within a team.
Get app in channel	teamsApp	Get an enabled app in the specified channel within a team.
Add app to channel	None	Add a teamsApp that enables an app in the specified channel within a team.
Remove app from channel	None	Remove a teamsApp that disables an app in the specified channel within a team.
Provision channel email address	provisionChannelEmailResult	Provision an email address for the channel.
Remove channel email address	None	Remove the email address of the channel.
Remove incoming channel	None	Remove an incoming channel (a channel shared with a team) from a team.
List teams sharing a channel	sharedWithChannelTeamInfo collection	Get the list of teams that has been shared a specified channel.
Get team sharing a channel	sharedWithChannelTeamInfo	Get a team which has been shared a specified channel.
Unshare channel with team	None	Unshare a channel with a team by deleting the corresponding sharedWithChannelTeamInfo resource.
List allowed members	conversationMember collection	Get the list of conversationMembers who can access a shared channel.
Check user access	Boolean	Determine whether a user has access to a shared channel.

Properties

Property	Type	Description
createdDateTime	dateTimeOffset	Read only. Timestamp at which the channel was created.
description	String	Optional textual description for the channel.
displayName	String	Channel name as it will appear to the user in Microsoft Teams. The maximum length is 50 characters.
email	String	The email address for sending messages to the channel. Read-only.
id	String	The channel's unique identifier. Read-only.
isArchived	Boolean	Indicates whether the channel is archived. Read-only.
isFavoriteByDefault	Boolean	Indicates whether the channel should be marked as recommended for all members of the team to show in their channel list. Note: All recommended channels automatically show in the channels list for education and frontline worker users. The property can only be set programmatically via the Create team method. The default value is false.
layoutType	channelLayoutType	The layout type of the channel. It can be set during creation and updated later. The possible values are: post, chat, unknownFutureValue. The default value is post. Channels with the post layout use a traditional post‑reply conversation format, and channels with the chat layout provide a chat‑like threading experience similar to group chats.
membershipType	channelMembershipType	The type of the channel. Can be set during creation and can't be changed. The possible values are: standard, private, unknownFutureValue, shared. The default value is standard. Use the Prefer: include-unknown-enum-members request header to get the following members in this evolvable enum: shared.
migrationMode	migrationMode	Indicates whether a channel is in migration mode. This value is null for channels that never entered migration mode. The possible values are: inProgress, completed, unknownFutureValue.
originalCreatedDateTime	dateTimeOffset	Timestamp of the original creation time for the channel. The value is null if the channel never entered migration mode.
tenantId	string	The ID of the Microsoft Entra tenant.
webUrl	String	A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.
summary	channelSummary	Contains summary information about the channel, including number of owners, members, guests, and an indicator for members from other tenants. The summary property will only be returned if it is specified in the $select clause of the Get channel method.

channelMembershipType values

Member	Description
standard	Channel inherits the list of members of the parent team.
private	Channel can have members that are a subset of all the members on the parent team.
unknownFutureValue	Evolvable enumeration sentinel value. Do not use.
shared	Members can be directly added to the channel without adding them to the team.

migrationMode values

Member	Description
inProgress	The channel or chat entered migration mode.
completed	The channel or chat is out of migration mode.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

channelLayoutType values

Member	Description
post	Traditional post-reply conversation format. Posts are displayed in a structured format with replies nested under the original post. Represents the default layout type.
chat	Chat-like threading experience similar to group chats. Messages are displayed in a continuous flow with support for threaded conversations on specific topics.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

Instance attributes

Instance attributes are properties with special behaviors. These properties are temporary and either a) define behavior the service should perform or b) provide short-term property values, like a download URL for an item that expires.

Property name	Type	Description
@microsoft.graph.channelCreationMode	string	Indicates that the channel is in migration state and is currently being used for migration purposes. It accepts one value: migration.

Note: channelCreationMode is an enum that takes the value migration.

For a POST request example, see Request (create channel in migration state).

Relationships

Relationship	Type	Description
allMembers	conversationMember collection	A collection of membership records associated with the channel, including both direct and indirect members of shared channels.
enabledApps	teamsApp collection	A collection of enabled apps in the channel.
filesFolder	driveItem	Metadata for the location where the channel's files are stored.
members	conversationMember collection	A collection of membership records associated with the channel.
messages	chatMessage collection	A collection of all the messages in the channel. A navigation property. Nullable.
operations	teamsAsyncOperation collection	The async operations that ran or are running on this team.
sharedWithTeams	sharedWithChannelTeamInfo collection	A collection of teams with which a channel is shared.
tabs	teamsTab collection	A collection of all the tabs in the channel. A navigation property.

JSON representation

The following JSON representation shows the resource type.

{
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "email": "String",
  "id": "String (identifier)",
  "isArchived": "Boolean",
  "isFavoriteByDefault": "Boolean",
  "layoutType": "String",
  "membershipType": "String",
  "migrationMode": "String",
  "originalCreatedDateTime": "String (timestamp)",
  "webUrl": "String"
}

Related content

• Channel lifecycle C# sample
• Channel lifecycle Node.js sample