Show / Hide Table of Contents

Channel.Create

Create channels in any team, on behalf of the signed-in user.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 A,D POST /teams/{team-id}/channels

Delegate Permission

Id 101147cf-4178-4455-9d58-02b5c164e759
Consent Type Admin
Display String Create channels
Description Create channels in any team, on behalf of the signed-in user.

Application Permission

Id f3a65bd4-b703-46df-8f7e-0174fea562aa
Display String Create channels
Description Create channels in any team, without a signed-in user.

Resources

channel

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.
isFavoriteByDefault Boolean Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with Create team. Default: false.
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. Note that you must use the Prefer: include-unknown-enum-members request header to get the following value in this evolvable enum: shared.
tenantId string The ID of the Azure Active Directory 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.

teamsAsyncOperation

Property Type Description
attemptsCount Int32 Number of times the operation was attempted before being marked successful or failed.
createdDateTime DateTimeOffset Time when the operation was created.
error operationError Any error that causes the async operation to fail.
id string Unique operation id.
lastActionDateTime DateTimeOffset Time when the async operation was last updated.
operationType teamsAsyncOperationType Denotes which type of operation is being described.
status teamsAsyncOperationStatus Operation status.
targetResourceId guid The ID of the object that's created or modified as result of this async operation, typically a team.
targetResourceLocation string The location of the object that's created or modified as result of this async operation. This URL should be treated as an opaque value and not parsed into its component paths.
In This Article
Back to top Created by merill | Submit feedback