Microsoft Teams Integration

Overview

Add Microsoft Teams to any ModuleX agent or workflow. Create channels, send channel and chat messages, list teams / channels / chats / messages / shifts, search messages, and retrieve the current user via the Microsoft Graph REST API (graph.microsoft.com/v1.0).

Categories: Communication · Productivity & Collaboration · Auth: OAuth2 · Actions: 12

Authentication

OAuth2 Authentication

Connect with your Microsoft work or school account using OAuth 2.0. Personal accounts are not supported by Microsoft Teams APIs.

Step 1

Go to https://entra.microsoft.com (Microsoft Entra admin center) and open ‘App registrations’

Step 2

Create a new registration (single-tenant or multi-tenant, as required by your deployment)

Step 3

Under Authentication, add the redirect URI: https://api.modulex.dev/credentials/oauth2/callback (type: Web)

Step 4

Under API permissions, add Microsoft Graph delegated permissions: User.Read, Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Read.All, ChannelMessage.Send, Chat.ReadWrite, ChatMessage.Send, Schedule.Read.All, Mail.Read, and offline_access

Step 5

Grant admin consent for the tenant if your organization requires it

Step 6

Under Certificates & secrets, create a Client Secret and copy its Value

Step 7

Copy the Application (client) ID and the Client Secret Value into ModuleX

Required Credentials

Field	Description	Required	Format
Client ID	Microsoft Entra Application (client) ID for the registered app.	Yes	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
Client Secret	Microsoft Entra Client Secret Value for the registered app.	Yes	`-`

OAuth Configuration

Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token
Scopes: offline_access, User.Read, Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Read.All, ChannelMessage.Send, Chat.ReadWrite, ChatMessage.Send, Schedule.Read.All, Mail.Read

Available Actions

create_channel — Create a new channel in Microsoft Teams.

Parameters

string

required

ID of the Microsoft Team. Obtain it via list_teams.

string

required

Display name of the channel.

string

Description of the channel.

Response

{
  "$defs": {
    "ChannelResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph Channel resource.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "displayName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Displayname"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "membershipType": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Membershiptype"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "ChannelResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "channel": {
      "anyOf": [
        {
          "$ref": "#/$defs/ChannelResource"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateChannelOutput",
  "type": "object"
}

get_chat_message — Get a specific message from a chat.

Parameters

string

required

ID of the chat. Obtain it via list_chats.

string

required

ID of the message to retrieve. Obtain it via list_messages_in_chat.

Response

{
  "$defs": {
    "ChatMessageResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph chatMessage resource (permissive — upstream returns many optional fields).",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "createdDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Createddatetime"
        },
        "from": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "From"
        },
        "body": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Body"
        },
        "importance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Importance"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "ChatMessageResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "$ref": "#/$defs/ChatMessageResource"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "GetChatMessageOutput",
  "type": "object"
}

get_current_user — Returns the authenticated Microsoft Teams user's ID, display name, email, and principal name via Microsoft Graph. Call this first when the user says 'my channels', 'my chats', or needs identity context.

Response

{
  "$defs": {
    "CurrentUser": {
      "additionalProperties": false,
      "description": "Subset of Microsoft Graph user resource returned by get_current_user.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "displayName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Displayname"
        },
        "mail": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail"
        },
        "userPrincipalName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Userprincipalname"
        }
      },
      "title": "CurrentUser",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "user": {
      "anyOf": [
        {
          "$ref": "#/$defs/CurrentUser"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "GetCurrentUserOutput",
  "type": "object"
}

list_channel_messages — Lists messages in a Microsoft Teams channel.

Parameters

string

required

ID of the Microsoft Team.

string

required

ID of the channel within the team.

integer

The maximum number of messages to return. Omit to fetch all available pages.

Response

{
  "$defs": {
    "ChatMessageResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph chatMessage resource (permissive — upstream returns many optional fields).",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "createdDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Createddatetime"
        },
        "from": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "From"
        },
        "body": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Body"
        },
        "importance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Importance"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "ChatMessageResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "messages": {
      "items": {
        "$ref": "#/$defs/ChatMessageResource"
      },
      "title": "Messages",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListChannelMessagesOutput",
  "type": "object"
}

list_channels — Lists all channels in a Microsoft Team.

Parameters

string

required

ID of the Microsoft Team.

Response

{
  "$defs": {
    "ChannelResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph Channel resource.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "displayName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Displayname"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "membershipType": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Membershiptype"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "ChannelResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "channels": {
      "items": {
        "$ref": "#/$defs/ChannelResource"
      },
      "title": "Channels",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListChannelsOutput",
  "type": "object"
}

list_chats — Lists all chat conversations for the authenticated user.

Response

{
  "$defs": {
    "ChatResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph Chat resource (with members expanded).",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "topic": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Topic"
        },
        "chatType": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Chattype"
        },
        "createdDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Createddatetime"
        },
        "lastUpdatedDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Lastupdateddatetime"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        },
        "members": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Members",
          "type": "array"
        }
      },
      "title": "ChatResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "chats": {
      "items": {
        "$ref": "#/$defs/ChatResource"
      },
      "title": "Chats",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListChatsOutput",
  "type": "object"
}

list_messages_in_chat — Get the list of messages in a chat, ordered by createdDateTime descending.

Parameters

string

required

ID of the chat.

integer

The maximum number of results to return. Omit to fetch all available pages.

Response

{
  "$defs": {
    "ChatMessageResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph chatMessage resource (permissive — upstream returns many optional fields).",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "createdDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Createddatetime"
        },
        "from": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "From"
        },
        "body": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Body"
        },
        "importance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Importance"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "ChatMessageResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "messages": {
      "items": {
        "$ref": "#/$defs/ChatMessageResource"
      },
      "title": "Messages",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListMessagesInChatOutput",
  "type": "object"
}

list_shifts — Get the list of shift instances for a team.

Parameters

string

required

ID of the Microsoft Team whose schedule is being queried.

Response

{
  "$defs": {
    "ShiftResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph Shift resource.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "userId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Userid"
        },
        "schedulingGroupId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Schedulinggroupid"
        },
        "createdDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Createddatetime"
        },
        "lastModifiedDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Lastmodifieddatetime"
        },
        "sharedShift": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Sharedshift"
        },
        "draftShift": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Draftshift"
        }
      },
      "title": "ShiftResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "shifts": {
      "items": {
        "$ref": "#/$defs/ShiftResource"
      },
      "title": "Shifts",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListShiftsOutput",
  "type": "object"
}

list_teams — Lists all teams the authenticated user has joined.

Response

{
  "$defs": {
    "TeamResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph Team resource.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "displayName": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Displayname"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "visibility": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Visibility"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "TeamResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "teams": {
      "items": {
        "$ref": "#/$defs/TeamResource"
      },
      "title": "Teams",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListTeamsOutput",
  "type": "object"
}

search_messages — Search for email or chat messages via Microsoft Graph search. Valid entity_type values: `message` (email), `chatMessage` (Teams chat messages).

Parameters

string

required

The type of entity to search for. Valid values: message for email, chatMessage for Teams chat messages.

string

required

The query string to search for.

integer

The index of the first result to return. (Default: 0)

integer

The number of results to return (max 25). (Default: 25)

Response

{
  "$defs": {
    "SearchResponse": {
      "additionalProperties": false,
      "description": "Microsoft Graph search response wrapper.",
      "properties": {
        "value": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Value",
          "type": "array"
        }
      },
      "title": "SearchResponse",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "result": {
      "anyOf": [
        {
          "$ref": "#/$defs/SearchResponse"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchMessagesOutput",
  "type": "object"
}

send_channel_message — Send a message to a team's channel. Optionally include inline images via `hosted_contents`.

Parameters

string

required

ID of the Microsoft Team.

string

required

ID of the channel within the team.

string

required

Message to be sent.

string

Whether the message body is plain text or HTML. Valid values: text, html. (Default: text)

array

An array of JSON strings, each representing an inline hosted image. Each item must be a JSON object with @microsoft.graph.temporaryId (string), contentBytes (base64-encoded image data), and contentType (MIME type, e.g. image/png). Reference each image in HTML message bodies using <img src="../hostedContents/1/$value">.

Response

{
  "$defs": {
    "ChatMessageResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph chatMessage resource (permissive — upstream returns many optional fields).",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "createdDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Createddatetime"
        },
        "from": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "From"
        },
        "body": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Body"
        },
        "importance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Importance"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "ChatMessageResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "$ref": "#/$defs/ChatMessageResource"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "SendChannelMessageOutput",
  "type": "object"
}

send_chat_message — Send a message to a team's chat.

Parameters

string

required

ID of the chat to post the message to.

string

required

Message to be sent.

string

Whether the message body is plain text or HTML. Valid values: text, html. (Default: text)

Response

{
  "$defs": {
    "ChatMessageResource": {
      "additionalProperties": false,
      "description": "Microsoft Graph chatMessage resource (permissive — upstream returns many optional fields).",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "createdDateTime": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Createddatetime"
        },
        "from": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "From"
        },
        "body": {
          "anyOf": [
            {
              "additionalProperties": true,
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Body"
        },
        "importance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Importance"
        },
        "webUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Weburl"
        }
      },
      "title": "ChatMessageResource",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "message": {
      "anyOf": [
        {
          "$ref": "#/$defs/ChatMessageResource"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "SendChatMessageOutput",
  "type": "object"
}

Limits & Quotas

Microsoft Graph applies per-app, per-tenant, and per-resource throttling. Teams messaging endpoints have specific RU-based limits documented at https://learn.microsoft.com/en-us/graph/throttling. Retry on HTTP 429 honoring the Retry-After header.
search_messages returns at most 25 results per call (upper bound enforced by the Microsoft Graph search API for this entity-type set). Use the from_ parameter to page beyond the first window.
Dynamic team / channel / chat / message pickers are not available — pass IDs directly; use the corresponding list_* action to enumerate IDs.
Webhook / change-notification subscriptions are not part of this integration; polling via the list_* actions is the supported pattern.
Error model: non-2xx responses and timeouts are caught and returned as success=False plus an error string rather than raising. Plan for retries on the agent side based on the error text.

Using

Providers

Building

Tools

Microsoft Teams Integration for AI Agents & Workflows

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Google Meet

Zoom

AgentMail

Links

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Google Meet

Zoom

AgentMail

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links