Microsoft Teams

Send messages in Microsoft Teams chats and channels, schedule meetings, and manage teams and members.

Actions

Action	What it does
Add member to team	Add a member to a Teams team.
Create channel	Create a new channel in a Teams team.
Get IDs from a Teams link	Get the team, channel, and organization (tenant) IDs from a Microsoft Teams link.
List joined teams	List all Teams the current user has joined.
List team channels	List channels in a Teams team.
List user chats	List chats for a user.
Schedule meeting	Schedule a Teams meeting.
Search team members	Search for members of a Teams team by name.
Send channel message	Send a message to a Teams channel.
Send chat message	Send a message to a Teams chat.

Add member to team

Add a member to a Teams team.

Inputs

Team IDms_team_idtextRequired: The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
User ID or emailms_user_idtextRequired: The user ID or email address of the person to add. You can find the ID with the Search team members action, or simply enter their email address.
Roleroletext: Optional role for the member (e.g., owner).

Outputs

ms_team_idtext: The team ID.
ms_user_idtext: The user ID.
resultobject: The member result.
statustext: Operation status.

Example output

{
  "ms_team_id": "team123",
  "ms_user_id": "user123",
  "result": {},
  "status": "success"
}

Create channel

Create a new channel in a Teams team.

Inputs

Team IDms_team_idtextRequired: The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
Channel namedisplay_nametextRequired: The name for the new channel.
Descriptiondescriptiontext: Optional description for the channel.

Outputs

channel_idtext: The created channel ID. Use as channel_id in send_channel_message.
ms_team_idtext: The team ID.
resultobject: The created channel.
statustext: Operation status.

Example output

{
  "channel_id": "channel123",
  "ms_team_id": "team123",
  "result": {},
  "status": "success"
}

Get IDs from a Teams link

Get the team, channel, and organization (tenant) IDs from a Microsoft Teams link.

Inputs

LinklinktextRequired: A Microsoft Teams URL (team or channel link).

Outputs

channel_idtext: The channel ID extracted from the link, if present. Use as channel_id in send_channel_message.
ms_team_idtext: The team (group) ID extracted from the link. Use as ms_team_id in other Teams actions.
statustext: Operation status.
tenant_idtext: The tenant ID extracted from the link, if present.

Example output

{
  "channel_id": "19:abc123@thread.tacv2",
  "ms_team_id": "72602e12-78ac-474c-99d6-f619710353a9",
  "status": "success",
  "tenant_id": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
}

List joined teams

List all Teams the current user has joined.

Inputs

Maximum resultstopnumber: Optional maximum number of teams to return.

Outputs

statustext: Operation status.
team_countnumber: Number of teams.
teamslist: List of teams.

Example output

{
  "status": "success",
  "team_count": 1,
  "teams": [
    {
      "description": "Engineering team",
      "displayName": "Engineering",
      "id": "72602e12-78ac-474c-99d6-f619710353a9"
    }
  ]
}

List team channels

List channels in a Teams team.

Inputs

Team IDms_team_idtextRequired: The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
Maximum resultstopnumber: Optional maximum number of channels to return.

Outputs

channel_countnumber: Number of channels.
channelslist: List of channels.
ms_team_idtext: The team ID.
statustext: Operation status.

Example output

{
  "channel_count": 1,
  "channels": [
    {
      "description": "General discussion",
      "displayName": "General",
      "id": "19:general@thread.tacv2"
    }
  ],
  "ms_team_id": "team123",
  "status": "success"
}

List user chats

List chats for a user.

Inputs

User IDms_user_idtext: The user ID. Defaults to 'me', the signed-in user.Default: me.

Outputs

chat_countnumber: Number of chats.
chatslist: List of chats.
ms_user_idtext: The user ID.
statustext: Operation status.

Example output

{
  "chat_count": 1,
  "chats": [
    {
      "chatType": "group",
      "id": "19:abc123@thread.v2",
      "topic": "Project Discussion"
    }
  ],
  "ms_user_id": "me",
  "status": "success"
}

Schedule meeting

Schedule a Teams meeting.

Inputs

Organizer IDorganizer_idtext: The organizer's user ID. Defaults to 'me', the signed-in user.Default: me.
SubjectsubjecttextRequired: The meeting subject.
Start date and timestart_datetimedate and timeRequired: When the meeting starts, for example 2026-07-15T09:00:00.
End date and timeend_datetimedate and timeRequired: When the meeting ends, for example 2026-07-15T10:00:00.
TimezonetimezonetextRequired: Time zone for the meeting (e.g., 'America/New_York').
AttendeesattendeeslistRequired: List of attendee email addresses.

Outputs

meeting_idtext: The created event ID.
organizer_idtext: The organizer user ID.
resultobject: The created event.
statustext: Operation status.

Example output

{
  "meeting_id": "event123",
  "organizer_id": "me",
  "result": {},
  "status": "success"
}

Search team members

Search for members of a Teams team by name.

Inputs

Team IDms_team_idtextRequired: The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
Name to search forquerytextRequired: The person's name to search for. Matches any part of the name and ignores capitalization.
Maximum resultstopnumber: Optional maximum number of results to return.

Outputs

member_countnumber: Number of matching members.
memberslist: List of matching members.
ms_team_idtext: The team ID.
statustext: Operation status.

Example output

{
  "member_count": 1,
  "members": [
    {
      "displayName": "John Doe",
      "email": "john@contoso.com",
      "id": "user123"
    }
  ],
  "ms_team_id": "team123",
  "status": "success"
}

Send channel message

Send a message to a Teams channel.

Inputs

Team IDms_team_idtextRequired: The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
Channel IDchannel_idtextRequired: The ID of the channel. You can find it with the List team channels, Get IDs from a Teams link, or Create channel actions.
MessagemessagetextRequired: The message content.

Outputs

channel_idtext: The channel ID.
ms_team_idtext: The team ID.
resultobject: The sent message.
statustext: Operation status.

Example output

{
  "channel_id": "channel123",
  "ms_team_id": "team123",
  "result": {},
  "status": "success"
}

Send chat message

Send a message to a Teams chat.

Inputs

Chat IDchat_idtextRequired: The ID of the chat. You can find it with the List user chats action.
MessagemessagetextRequired: The message content.
Subjectsubjecttext: Optional message subject.

Outputs

chat_idtext: The chat ID.
resultobject: The sent message.
statustext: Operation status.

Example output

{
  "chat_id": "chat123",
  "result": {},
  "status": "success"
}

ActionsCopy Anchor Link

Add member to teamCopy Anchor Link

Inputs

Outputs

Create channelCopy Anchor Link

Inputs

Outputs

Get IDs from a Teams linkCopy Anchor Link

Inputs

Outputs

List joined teamsCopy Anchor Link

Inputs

Outputs

List team channelsCopy Anchor Link

Inputs

Outputs

List user chatsCopy Anchor Link

Inputs

Outputs

Schedule meetingCopy Anchor Link

Inputs

Outputs

Search team membersCopy Anchor Link

Inputs

Outputs

Send channel messageCopy Anchor Link

Inputs

Outputs

Send chat messageCopy Anchor Link

Inputs

Outputs

On this page

Actions

Add member to team

Create channel

Get IDs from a Teams link

List joined teams

List team channels

List user chats

Schedule meeting

Search team members

Send channel message

Send chat message