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:
|
Dropdown |
TRUE |
User IDs |
A unique identifier for the user.
|
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 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:
For a full list of possible status codes, see HTTP status codes. |
Number |