Add Member to Channel

Add a member to a Microsoft Teams channel. Members can only be added to private channels.


Field Definition Type Required
ID Unique ID of the user. String TRUE
As Owner? If true, the user is added to the channel as an owner. If false the user is added to the channel as a member. Boolean FALSE
ID Unique ID of the team. String TRUE
ID Unique ID of the channel. String TRUE


Field Definition Type
ID Unique ID of the conversation member. String
Display Name Display name of the member. String
Roles Role of the user in the team. Possible values are owner or if the roles input field is left blank, members is returned by default. List of Stings
Email Email address for sending messages to the channel. String
User ID

Unique identifier of the user.

Visible History Start Date Time Timestamp denoting how far back a conversation's history is shared with the conversation members. Date and 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.


Related topics

Microsoft Teams connector

Workflow elements

Guidance for Microsoft Teams connector

Microsoft Teams API overview