Create Channel

Create a Microsoft Teams channel.

Additional information

Add users to private channels only.
All users who have been added to a private channel must already be a member of the team.
Users previously added to private channels can only be removed from private channels.
All user IDs passed into the card are made owners of the private channel.
The user account used to create the Okta Workflows connection is automatically added to the list of users by the connector. It isn't necessary to pass in the user ID for the connected user.

Input

Field	Definition	Type	Required
Team
ID	Unique ID of the team.	Text	TRUE
Channel
Display Name	Display name of the channel. Maximum limit of 50 characters.	Text	TRUE
Description	Description for the channel.	Text	FALSE
Is Favorite By Default	Indicates whether the channel should automatically be marked as recommended for all members of the team.	True/False	FALSE
Membership Type	Type of the channel. Possible values are: Standard: Channel inherits the list of all members of the parent team. Private: Channel can have members that are a subset of all the members on the parent team. Limit of 30 private channels per team. Members can only be added to private channels. Members can only be removed from private channels.	Dropdown	TRUE
User IDs	A unique identifier for the user. Users can only be added to private channels. Users can only be removed from private channels.	List of Text	TRUE

For Membership Type, when you create a Private channel, the entire team is added as members of the channel. After a delay, the user who created the Workflows connection is assigned as an owner of the channel.

Output

Field	Definition	Type
ID	Unique ID of the channel.	Text
Display Name	Display name of the channel.	Text
Description	Description for the channel.	Text
Email	Email address for sending messages to the channel.	Text
Is Favorite By Default	Indicates whether the channel should automatically be marked as recommended for all members of the team.	True/False
Web URL	Hyperlink that goes to the team in the Microsoft Teams client. This is the URL that you get when you right-click a team in the Microsoft Teams client and select Get link to team.	Text
Membership Type	Specifies the type of the channel. Possible values are Standard and Private.	Text
Created Date Time	Date and time that the channel was created.	Date & Time
Status Code	Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example: A 201 Created status code indicates success where a new resource was created. A 403 Forbidden error indicates that the HTTP request wasn't processed because the necessary permissions were missing. For a full list of possible status codes, see HTTP status codes.	Number

Create Channel

Additional information

Input

Output

Related topics