---
title: Migrate from Office 365 Connectors in Microsoft Teams
description: >-
  Steps to migrate from legacy Office 365 connectors to the Microsoft Teams
  integration.
breadcrumbs: >-
  Docs > Integrations > Integration Guides > Migrate from Office 365 Connectors
  in Microsoft Teams
---

# Migrate from Office 365 Connectors in Microsoft Teams

## Overview{% #overview %}

Microsoft has retired Office 365 connectors for Microsoft Teams. All connectors stop working on April 30, 2026. See Microsoft's [blog post](https://devblogs.microsoft.com/microsoft365dev/retirement-of-office-365-connectors-within-microsoft-teams/) for timeline details.

This guide covers two migration options:

- **Tenant-based integration (recommended)**: Migrate to the Datadog app for Microsoft Teams, which connects your Microsoft tenant directly to Datadog.
- **Microsoft Workflows Webhooks**: Migrate to webhook-based handles using Microsoft's Power Automate Workflows.

## Migrate legacy connectors to tenant-based integration{% #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](https://docs.datadoghq.com/integrations/microsoft-teams/#setup) to connect your Microsoft tenant to Datadog.
1. Add the  app to all teams where you have a legacy Office 365 connector configured.
1. For each legacy notification connector handle in the [Microsoft Teams Integration Tile](https://app.datadoghq.com/integrations/microsoft-teams):
   1. Under the configured tenant, click **Add Handle**.
   1. 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`.
   1. 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{% #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](https://docs.datadoghq.com/integrations/microsoft-teams/#setup) to create a workflow webhook handle for the desired Microsoft Teams channel.
1. 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{% #further-reading %}

- [Set up Microsoft Teams in Datadog](https://docs.datadoghq.com/integrations/microsoft-teams)
- [Troubleshooting Microsoft Teams](https://docs.datadoghq.com/integrations/guide/microsoft_teams_troubleshooting)