Microsoft Teams

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

Add member to team

Add a member to a Teams team.

Parameters

Parameter	Type	Required	Description
`ms_team_id`	string	Yes	The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
`ms_user_id`	string	Yes	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.
`role`	string	No	Optional role for the member (e.g., owner).

Response

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

Create channel

Create a new channel in a Teams team.

Parameters

Parameter	Type	Required	Description
`ms_team_id`	string	Yes	The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
`display_name`	string	Yes	The name for the new channel.
`description`	string	No	Optional description for the channel.

Response

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

List joined teams

List all Teams the current user has joined.

Parameters

Parameter	Type	Required	Description
`top`	number	No	Optional maximum number of teams to return.

Response

{
  "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.

Parameters

Parameter	Type	Required	Description
`ms_team_id`	string	Yes	The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
`top`	number	No	Optional maximum number of channels to return.

Response

{
  "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.

Parameters

Parameter	Type	Required	Description
`ms_user_id`	string	No	The user ID. Defaults to 'me', the signed-in user.

Response

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

Get IDs from a Teams link

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

Parameters

Parameter	Type	Required	Description
`link`	string	Yes	A Microsoft Teams URL (team or channel link).

Response

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

Schedule meeting

Schedule a Teams meeting.

Parameters

Parameter	Type	Required	Description
`organizer_id`	string	No	The organizer's user ID. Defaults to 'me', the signed-in user.
`subject`	string	Yes	The meeting subject.
`start_datetime`	string	Yes	When the meeting starts, for example 2026-07-15T09:00:00.
`end_datetime`	string	Yes	When the meeting ends, for example 2026-07-15T10:00:00.
`timezone`	string	Yes	Time zone for the meeting (e.g., 'America/New_York').
`attendees`	array	Yes	List of attendee email addresses.

Response

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

Search team members

Search for members of a Teams team by name.

Parameters

Parameter	Type	Required	Description
`ms_team_id`	string	Yes	The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
`query`	string	Yes	The person's name to search for. Matches any part of the name and ignores capitalization.
`top`	number	No	Optional maximum number of results to return.

Response

{
  "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.

Parameters

Parameter	Type	Required	Description
`ms_team_id`	string	Yes	The ID of the team. You can find it with the List joined teams or Get IDs from a Teams link actions.
`channel_id`	string	Yes	The ID of the channel. You can find it with the List team channels, Get IDs from a Teams link, or Create channel actions.
`message`	string	Yes	The message content.

Response

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

Send chat message

Send a message to a Teams chat.

Parameters

Parameter	Type	Required	Description
`chat_id`	string	Yes	The ID of the chat. You can find it with the List user chats action.
`message`	string	Yes	The message content.
`subject`	string	No	Optional message subject.

Response

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

Microsoft Teams

On this page