For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/guide/microsoft_teams_migrate_legacy_connectors.md. A documentation index is available at /llms.txt.

Migrate from Office 365 Connectors in Microsoft Teams

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

Overview

Microsoft has retired Office 365 connectors for Microsoft Teams. All connectors stop working on April 30, 2026. See Microsoft’s blog post for timeline details.

This guide covers two migration options:

Migrate legacy connectors to tenant-based integration

To migrate all notification handles currently using the legacy Office 365 connectors over to the tenant-based Datadog app:

  1. Follow the setup steps to connect your Microsoft tenant to Datadog.
  2. Add the app to all teams where you have a legacy Office 365 connector configured.
  3. For each legacy notification connector handle in the Microsoft Teams Integration Tile:
    1. Under the configured tenant, click Add Handle.
    2. Give the new handle the same name as the connector handle. For example, if your legacy connector handle is named channel-123, create a new handle in the tenant configuration with the name channel-123.
    3. Select the team and channel that the legacy connector handle was sending to, and click Save. This new handle overrides the existing legacy connector handle.

Migrate legacy connectors to the Microsoft Workflows Webhooks integration

To migrate all notification handles currently using the legacy Office 365 connectors over to Datadog’s Microsoft Workflows Webhooks integration:

  1. Follow the setup steps to create a workflow webhook handle for the desired Microsoft Teams channel.
  2. In the Datadog integration tile, under the Microsoft Workflows Webhooks section, give the new handle the same name as the connector handle it should replace. For example, if your legacy connector handle is named channel-123, name your new handle channel-123. This new handle overrides the existing legacy connector handle.

Further reading

Additional helpful documentation, links, and articles:

Set up Microsoft Teams in DatadogDOCUMENTATION more more Troubleshooting Microsoft TeamsGUIDE more more