Skip to main content

​
What can you do with it?

Microsoft Teams enables you to manage your team’s communication and collaboration programmatically. You can list teams you’ve joined, browse channels within teams, send messages to channels, and create rich formatted messages with HTML content. This integration is perfect for automated notifications, team updates, workflow alerts, and integrating external systems with your Teams workspace.

​
How to use it?

​
Basic Command Structure

/your-Microsoft-Teams-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:
  • action - The operation to perform with Teams

​
Tools

​
Get Joined Teams

List all teams you are a member of Parameters: None required Example: 
/your-Microsoft-Teams-connection
action: get-joined-teams
Response: 
{
  "@odata.count": 2,
  "value": [
    {
      "id": "07ae54af-4798-4a8e-82c8-7622ea72ab93",
      "displayName": "Engineering Team",
      "description": "Main engineering collaboration",
      "isArchived": false,
      "tenantId": "b46265dc-2bc5-4871-a9e8-a9a15c21eaf5"
    },
    {
      "id": "team-id-2",
      "displayName": "Product Team",
      "description": "Product development discussions"
    }
  ]
}

​
Get Team Channels

List all channels in a specific team Parameters:
  • team-id (required) - The ID of the team
Example: 
/your-Microsoft-Teams-connection
action: get-channels
team-id: 07ae54af-4798-4a8e-82c8-7622ea72ab93
Response: 
{
  "@odata.count": 3,
  "value": [
    {
      "id": "19:gnTox9eJhkJTinUgyLpLFzaTA7RjwQgQjiP_SG1LpvE1@thread.tacv2",
      "displayName": "General",
      "description": "General team discussions",
      "createdDateTime": "2024-11-20T14:44:11.727Z",
      "membershipType": "standard"
    },
    {
      "id": "channel-id-2",
      "displayName": "Development",
      "description": "Code reviews and technical discussions"
    }
  ]
}

​
Send Channel Message

Send a text message to a team channel Parameters:
  • team-id (required) - The ID of the team
  • channel-id (required) - The ID of the channel
  • message (required) - The message content to send
Example: 
/your-Microsoft-Teams-connection
action: send-message
team-id: 07ae54af-4798-4a8e-82c8-7622ea72ab93
channel-id: 19:gnTox9eJhkJTinUgyLpLFzaTA7RjwQgQjiP_SG1LpvE1@thread.tacv2
message: Hello team! The deployment was successful.
Response: 
{
  "id": "1732208611283",
  "body": {
    "content": "Hello team! The deployment was successful.",
    "contentType": "text"
  },
  "from": {
    "user": {
      "displayName": "John Doe",
      "id": "1c205ba6-26bc-41de-bcf3-761cababdd25"
    }
  },
  "createdDateTime": "2024-11-21T17:03:31.283Z",
  "channelIdentity": {
    "channelId": "19:gnTox9eJhkJTinUgyLpLFzaTA7RjwQgQjiP_SG1LpvE1@thread.tacv2",
    "teamId": "07ae54af-4798-4a8e-82c8-7622ea72ab93"
  },
  "importance": "normal"
}

​
Send Rich Message

Send a formatted message with HTML content and subject Parameters:
  • team-id (required) - The ID of the team
  • channel-id (required) - The ID of the channel
  • subject (required) - The message subject
  • content (required) - HTML formatted content
  • importance (optional) - Message importance: normal, high, or urgent (default: normal)
Example: 
/your-Microsoft-Teams-connection
action: send-rich-message
team-id: 07ae54af-4798-4a8e-82c8-7622ea72ab93
channel-id: 19:gnTox9eJhkJTinUgyLpLFzaTA7RjwQgQjiP_SG1LpvE1@thread.tacv2
subject: Weekly Status Update
content: <h2>Project Status</h2><ul><li>✅ Feature A completed</li><li>🔄 Feature B in progress</li></ul>
importance: high
Response: 
{
  "id": "1732208611284",
  "subject": "Weekly Status Update",
  "body": {
    "content": "<h2>Project Status</h2><ul><li>✅ Feature A completed</li><li>🔄 Feature B in progress</li></ul>",
    "contentType": "html"
  },
  "from": {
    "user": {
      "displayName": "John Doe",
      "id": "1c205ba6-26bc-41de-bcf3-761cababdd25"
    }
  },
  "createdDateTime": "2024-11-21T17:05:45.123Z",
  "importance": "high",
  "messageType": "message"
}

​
Notes

Both PinkConnect and Paragon proxies are supported for Teams operations. Rich messages support HTML formatting for enhanced visual presentation. Messages are sent on behalf of the authenticated user. Team and channel IDs are required for messaging - use the listing tools to obtain these IDs first. The membershipType field in channels indicates standard or private channels.