Microsoft Teams
With Microsoft Teams modules in Make, you can monitor, list, create, update, delete, and retrieve teams and channels in your Microsoft Teams account.
To use the Microsoft Teams modules, you must have a Microsoft business account. You also should be an admin of the account and Microsoft Office 365 Premium must be activated for your admin business account. You can create an account at https://www.microsoft.com/en-us/microsoft-365/business.
Refer to the Microsoft Teams API documentation for a list of available endpoints.
To establish the connection in Make:
- Log in to your Make account, add a Microsoft Teams module to your , and click Create a connection.
- Optional: In the Connection name field, enter a name for the connection.
- Optional: Click Show advanced settings to enter your custom app client credentials, tenant ID, and add additional scopes as needed. Refer to the Microsoft Teams documentation regarding client credentials.If requested, use the following Redirect URI when creating your custom app: https://www.integromat.com/oauth/cb/azure.
- Click Save.
- If prompted, authenticate your account and confirm access.
You have successfully established the connection. You can now edit your and add more Microsoft Teams modules. If your connection requires reauthorization at any point, follow the connection renewal steps here.
You can watch, list, retrieve, create, update teams and create and update teams for groups with the following modules.
Retrieves a team's details when a new team/group is created or an existing team is edited.
Connection | |
|---|---|
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. |
Retrieves all the teams in Microsoft Teams that you are a member of.
Connection | |
|---|---|
Limit | Set the maximum number of teams Make will return during one execution cycle. |
Returns all teams (including Office 365 Groups) in your account.
Connection | |
|---|---|
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. |
Returns a team's/group's details.
Connection | |
|---|---|
Group ID | Enter (map) or select the ID of the team/group you want to retrieve details about. |
Creates a new Office 365 group (unified group) or Security group.
You can't currently create a team via this module.
Connection | |
|---|---|
Display Name | Enter the name that is displayed in the address book for the group. |
Alias for Group | |
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. |
Creates a new Office 365 group (unified group) or Security group.
You can't currently create a team via this module.
Connection | |
|---|---|
Display Name | Enter the name that is displayed in the address book for the group. |
Alias for Group | Enter the mail alias (nickname) for the group. Alias can only contain lowercase letters, numbers, and underscores. For Security Group type, simply provide an alias 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. |
Updates a group's/team's properties.
Connection | |
|---|---|
Group ID | Enter the ID or select the group/team you want to update. |
Visibility | Set the Office 365 group to public or private. |
Creates a new team from a group.
If the group was created less than 15 minutes ago, it's possible for the Create Team module to fail with a 404 error code due to replication delays. The recommended pattern is to re-run the Create Team module three times, with a 10 seconds delay between calls.
Connection | |
|---|---|
Group ID | Enter the ID or select the group from which you want to create a team. |
Admin and Settings | Set the team's Member Settings, Messaging Settings, Fun Settings, and Guest Settings. |
Deletes a team/group.
Connection | |
|---|---|
Group ID | Enter the ID or select the group you want to delete. |
You can list, retrieve, create, update, and delete channels with the following modules.
Lists all channels in the Microsoft Team.
Connection | |
|---|---|
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. |
Retrieves the properties and relationship of a channel.
Connection | |
|---|---|
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. |
Creates a new channel in a Microsoft Team.
Connection | |
|---|---|
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. |
Updates the properties of the specified channel.
Connection | |
|---|---|
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. |
Updates the properties of the specified channel.
Connection | |
|---|---|
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. |
You can watch and send messages and replies with the following modules.
Triggers when someone sends a message in a team's channel or in a chat.
Connection | |
|---|---|
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. |
Triggers when a new reply to a selected message is received. Not available for personal accounts.
Connection | |
|---|---|
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. |
Triggers when a new reply to a selected message is received. Not available for personal accounts.
Connection | |
|---|---|
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. |
Sends a message to a team's channel or to a chat.
Connection | |
|---|---|
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. |
You can add members to teams and to groups with the following modules.
Adds a new member.
Connection | |
|---|---|
Enter a Member Name | Enter the new member's name. |
Password Profile | Enter the new member's profile password. |
Adds a member to an Office 365 Group.
Connection | |
|---|---|
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. |
You can create, retrieve, update, and delete online meetings with the following modules.
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 | |
|---|---|
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.
|
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.
|
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.
|
Record Automatically | Select or map whether to record the meeting automatically. |
Updates an online meeting by its ID.
Connection | |
|---|---|
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.
|
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.
|
Record Automatically | Select or map whether to record the meeting automatically. |
Retrieves an online meeting by its ID.
Connection | |
|---|---|
Meeting ID | Enter the ID associated with the online meeting. |
Retrieves an online meeting by its ID.
Connection | |
|---|---|
Meeting ID | Enter the ID associated with the online meeting. |
You can search users, retrieve users' statuses, and call APIs with the following modules.
Searches for users by a filter parameter.
Connection | |
|---|---|
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. |
Retrieves the selected users' availability and activity status.
Connection | |
|---|---|
User IDs | Select or map the users whose status you want to retrieve. |
Allows you to perform a custom API call.
Connection | |
|---|---|
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. |
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:
- Add a Member - offline_access, User.Read, User.ReadWrite.All
- Add a Member to a Group - offline_access, User.Read, User.Read.All, GroupMember.ReadWrite.All
- Create a Channel - offline_access, User.Read, Group.ReadWrite.All
- Create an Office 365 Group - offline_access, User.Read, Group.ReadWrite.All, User.Read.All
- Create a Team from a Group - offline_access, User.Read, Group.ReadWrite.All
- Create an Online Meeting - offline_access, User.Read, OnlineMeetings.ReadWrite
- Delete a Channel - offline_access, User.Read, Group.ReadWrite.All
- Delete a Team or Group - offline_access, User.Read, Group.ReadWrite.All
- Delete an Online Meeting - offline_access, User.Read, OnlineMeetings.ReadWrite
- Get a Channel - offline_access, User.Read, Group.Read.All
- Get an Online Meeting - offline_access, User.Read, OnlineMeetingArtifact.Read.All, OnlineMeetings.Read
- Get a Team - offline_access, User.Read, Group.Read.All
- Get User's Presence - offline_access, User.Read, Presence.Read.All, User.Read.All
- List All Teams & Groups - offline_access, User.Read, Group.Read.All
- List Channels - offline_access, User.Read, Group.Read.All
- List Jointed Teams - offline_access, User.Read, Group.Read.All
- Reply to a Channel Message - offline_access, User.Read, ChannelMessage.Send, Group.Read.All, ChannelMessage.Read.All
- Search Users - offline_access, User.Read, User.Read.All
- Send a Message - offline_access, User.Read, ChannelMessage.Send, Chat.ReadWrite, User.Read.All, Group.Read.All
- Update a Channel - offline_access, User.Read, Group.ReadWrite.All
- Update an Online Meeting - offline_access, User.Read, OnlineMeetings.ReadWrite
- Update a Team - offline_access, User.Read, Group.ReadWrite.All
- Watch Messages - offline_access, User.Read, ChannelMessage.Read.All, Chat.Read
- Watch New Replies - offline_access, User.Read, ChannelMessage.Read.All, Group.Read.All
- Watch Teams - offline_access, User.Read, Group.Read.All
- Make an API Call - offline_access, User.Read