Communication
Microsoft Teams
Microsoft Teams modules
17 min
after connecting to the microsoft teams app, you can use the following modules to build your {{scenario plural lowercase}} team you can watch, list, retrieve, create, update teams and create and update teams for groups with the following modules watch teams retrieves a team's details when a new team/group is created or an existing team is edited connection microsoft teams docid\ ptmcp4elgse6qfocxohld filter define the filter settings for the returned groups you can retrieve only groups whose name or email starts with the specified term limit set the maximum number of results make will return during one execution cycle create an office 365 group creates a new office 365 group (unified group) or security group you can't currently create a team via this module connection microsoft teams docid\ ptmcp4elgse6qfocxohld display name enter the name that is displayed in the address book for the group alias for group enter a unique alias for the group the alias is used as the group's email address and must only contain lowercase letters, numbers, and underscores for security groups, simply provide an alias to use as a nickname group type enable the unified option (or enter "unified") to create an office 365 group otherwise, the security group (used for granting access to sharepoint resources) is created description enter the description of the group security enabled enable this option if a group is a security group and you have not enabled the "unified" option in the group type field owners select the owners of the group the owners are a set of non admin users who can modify this object members select users and groups that are members of this group create a team from a group create microsoft team by calling from office 365 group if the group was created less than 15 minutes ago, it's possible for the create a team from a group module to fail with a 404 error code due to replication delays the recommended pattern is to re run this module three times, with a 10 seconds delay between calls connection microsoft teams docid\ ptmcp4elgse6qfocxohld group id select the group id that you want to create a team from member settings select whether you want to allow the following permissions create & update channels delete channels add & remove apps create, update & remove tabs create, update & remove connectors messaging settings select whether you want to allow the following permissions edit messages user delete messages owner delete messages team mentions channel mentions fun settings select whether you want to allow the following permissions giphy stickers and memes custom memes guest settings select whether you want to allow the following permissions create & update channels delete channels update a team updates a group's/team's properties connection microsoft teams docid\ ptmcp4elgse6qfocxohld group id enter the id or select the group/team you want to update visibility set the office 365 group to public or private get a team returns a team's/group's details connection microsoft teams docid\ ptmcp4elgse6qfocxohld group id enter (map) or select the id of the team/group you want to retrieve details about list all teams & groups returns all teams (including office 365 groups) in your account connection microsoft teams docid\ ptmcp4elgse6qfocxohld filter define the filter settings for the returned groups you can retrieve only groups whose name or email starts with the specified term order by select whether to order results by displaying names in ascending or descending order limit set the maximum number of teams make will return during one execution cycle list joined teams retrieves all the teams in microsoft teams that you are a member of connection microsoft teams docid\ ptmcp4elgse6qfocxohld limit set the maximum number of teams make will return during one execution cycle delete a team or group deletes a team/group connection microsoft teams docid\ ptmcp4elgse6qfocxohld group id enter the id or select the group you want to delete channel you can list, retrieve, create, update, and delete channels with the following modules create a channel creates a new channel in a microsoft team connection microsoft teams docid\ ptmcp4elgse6qfocxohld team id enter the id or select the team you want to create a channel for channel name enter the name for the new channel description enter the channel description update a channel updates the properties of the specified channel connection microsoft teams docid\ ptmcp4elgse6qfocxohld team id enter the id or select the team that contains the channel you want to update channel id enter the id or select the channel you want to update get a channel retrieves the properties and relationship of a channel connection microsoft teams docid\ ptmcp4elgse6qfocxohld team id enter the id or select the team that contains the channel you want to retrieve details about channel id enter the id or select the channel you want to retrieve details about list channels lists all channels in the microsoft team connection microsoft teams docid\ ptmcp4elgse6qfocxohld team id enter the id or select the team you want to list channels from limit set the maximum number of channels make will return during one execution cycle delete a channel updates the properties of the specified channel connection microsoft teams docid\ ptmcp4elgse6qfocxohld team id enter the id or select the team that contains the channel you want to delete channel id enter the id or select the channel you want to delete message you can watch and send messages and replies with the following modules watch messages triggers when someone sends a message in a team's channel or in a chat connection microsoft teams docid\ ptmcp4elgse6qfocxohld choose a type of messages to be watched select the types of messages you want to watch you can choose between channel and chat messages team id only appears for channel messages select or map the team id whose channel messages you want to watch channel id only appears for channel messages select or map the channel id whose messages you want to watch chat id only appears for chat messages select or map the chat id whose messages you want to watch limit set the maximum number of messages make will return during one execution cycle watch new replies triggers when a new reply to a selected message is received not available for personal accounts connection microsoft teams docid\ ptmcp4elgse6qfocxohld team id select or map the team id whose replies you want to watch channel id select or map the channel id whose replies you want to watch message id select or map the message id whose replies you want to watch limit set the maximum number of messages make will return during one execution cycle send a message sends a message to a team's channel or to a chat connection microsoft teams docid\ ptmcp4elgse6qfocxohld send a message select a message type you want to send you can choose a channel or chat message team id only appears for channel messages select or map the team id to which you want to send the message channel id only appears for channel messages select or map the channel id to which you want to send the message create a new chat only appears for channel messages select either yes or no yes to create a new chat chat type only appears for channel messages select or map either one on one or group message enter the message text content type select or map the format in which you want to send the message for example, html attachments add attachments to be included with the message the attachment must be a onedrive link external public links will result in an error reply to a channel message creates a new reply to a message in the specified channel connection microsoft teams docid\ ptmcp4elgse6qfocxohld team id enter (map) the id of the team that contains the channel you want to reply in channel id enter (map) the id of the channel where the message you want to reply to is located message id enter (map) the id of the original message you want to reply to reply message enter the text you want to send as the reply content type select the format in which you want to send the message text html member you can add members to teams and to groups with the following modules add a member adds a new member connection microsoft teams docid\ ptmcp4elgse6qfocxohld enter a member name enter the new member's name password profile enter the new member's profile password add a member to a group adds a member to an office 365 group connection microsoft teams docid\ ptmcp4elgse6qfocxohld group id select or map the group id to which you want to add the member member id select or map the member id whom you want to add to the group online meeting you can create, retrieve, update, and delete online meetings with the following modules create an online meeting creates an online meeting this will be a standalone meeting that is not associated with any event on the user's calendar; therefore, meetings created via this module will not show on the user's calendar connection microsoft teams docid\ ptmcp4elgse6qfocxohld subject enter the subject of the online meeting start date and time enter the meeting start time end date and time enter the meeting end time allowed presenters select or map a type of user who can be a presenter in the meeting attendees information about a participant in a meeting identity > user > id select or map the id of the user who is attending role select or map the attendee's role in the online meeting allow attendee to enable camera select or map whether attendees can turn on their cameras allow attendee to enable mic select or map whether attendees can turn on their microphones allow meeting chat select or map whether to enable meeting chat allow teamwork reactions select or map whether to enable reactions for the meeting chat info enter the chat information associated with this online meeting thread id enter the id of a thread in the microsoft teams channel message id enter the id of a message in a microsoft teams channel reply chain message id enter the id of the reply message is entry and exit announced select or map whether to announce when callers join or leave lobby bypass settings select or map which participants can bypass the meeting lobby scope select or map the type of participants that are automatically admitted into a meeting, bypassing the lobby is dial in bypass enabled select or map whether or not to always let dial in callers bypass the lobby record automatically select or map whether to record the meeting automatically update an online meeting updates an online meeting by its id connection microsoft teams docid\ ptmcp4elgse6qfocxohld meeting id enter the id associated with the online meeting subject enter the subject of the online meeting start date and time enter the meeting start time end date and time enter the meeting end time allowed presenters select or map a type of user who can be a presenter in the meeting attendees information about a participant in a meeting identity > user > id select or map the id of the user who is attending role select or map the attendee's role in the online meeting allow attendee to enable camera select or map whether attendees can turn on their cameras allow attendee to enable mic select or map whether attendees can turn on their microphones allow meeting chat select or map whether to enable meeting chat allow teamwork reactions select or map whether to enable reactions for the meeting is entry and exit announced select or map whether to announce when callers join or leave lobby bypass settings select or map which participants can bypass the meeting lobby scope select or map the type of participants that are automatically admitted into a meeting, bypassing the lobby is dial in bypass enabled select or map whether or not to always let dial in callers bypass the lobby record automatically select or map whether to record the meeting automatically get an online meeting retrieves an online meeting by its id connection microsoft teams docid\ ptmcp4elgse6qfocxohld meeting id enter the id associated with the online meeting delete an online meeting retrieves an online meeting by its id connection microsoft teams docid\ ptmcp4elgse6qfocxohld meeting id enter the id associated with the online meeting other you can search users, retrieve users' statuses, and call apis with the following modules search users searches for users by a filter parameter connection microsoft teams docid\ ptmcp4elgse6qfocxohld filter add filters to search for users who match your specified filters limit set the maximum number of users make will return during one execution cycle get user's presence retrieves the selected users' availability and activity status connection microsoft teams docid\ ptmcp4elgse6qfocxohld user ids select or map the users whose status you want to retrieve make an api call allows you to perform a custom api call connection microsoft teams docid\ ptmcp4elgse6qfocxohld url enter a path relative to https //graph microsoft com e g /v1 0/teams/\<team id>/channels – where the \<group id> is the id of the team you want to retrieve channels from for the list of available endpoints, refer to the microsoft graph rest api reference method select the http method you want to use get to retrieve information for an entry post to create a new entry put to update/replace an existing entry patch to make a partial entry update delete to delete an entry headers enter the desired request headers you don't have to add authorization headers; we already did that for you query string enter the request query string body enter the body content for your api call example of use list team's channels the following api call returns a list of all channels from the specified team in your microsoft teams account url /v1 0/teams/7d0845d0 5015 4d1e 8cfc 4628f53a237d/channels where the 7d0845d0 5015 4d1e 8cfc 4628f53a237d is the group id of the team you want to retrieve channels from you can retrieve the group id, for example, using the list all teams > groups or watch teams module method get matches of the search can be found in the module's output under bundle > body > value in our example, 9 channels were returned