{
  "doc": {
    "id": "cloud/integrations/teams",
    "title": "Microsoft Teams Integration",
    "description": "Setup Microsoft Teams notifications for your Cypress Cloud organization and projects.",
    "section": "cloud",
    "source_path": "/llm/markdown/cloud/integrations/teams.md",
    "version": "ce02913654e2655ee63448bdc92bb92c7b46a619",
    "updated_at": "2026-04-22T19:37:51.587Z",
    "headings": [
      {
        "id": "cloud/integrations/teams#microsoft-teams-integration",
        "text": "Microsoft Teams Integration",
        "level": 1
      },
      {
        "id": "cloud/integrations/teams#what-youll-learn",
        "text": " What you'll learn",
        "level": 5
      },
      {
        "id": "cloud/integrations/teams#enable-the-microsoft-teams-integration",
        "text": "Enable the Microsoft Teams integration",
        "level": 2
      },
      {
        "id": "cloud/integrations/teams#per-organization-configuration-all-projects",
        "text": "Per-organization configuration (all projects)",
        "level": 3
      },
      {
        "id": "cloud/integrations/teams#remove-a-webhook",
        "text": "Remove a webhook",
        "level": 4
      },
      {
        "id": "cloud/integrations/teams#per-project-configuration",
        "text": "Per-project configuration",
        "level": 3
      },
      {
        "id": "cloud/integrations/teams#notification-preferences",
        "text": "Notification preferences",
        "level": 2
      },
      {
        "id": "cloud/integrations/teams#filter-notifications-by-tag-or-run-group",
        "text": "Filter notifications by tag or run group",
        "level": 3
      },
      {
        "id": "cloud/integrations/teams#mute-a-channel",
        "text": "Mute a channel",
        "level": 3
      }
    ]
  },
  "content": {
    "type": "root",
    "children": [
      {
        "type": "heading",
        "depth": 1,
        "children": [
          {
            "type": "text",
            "value": "Microsoft Teams Integration"
          }
        ]
      },
      {
        "type": "heading",
        "depth": 5,
        "children": [
          {
            "type": "text",
            "value": " What you'll learn"
          }
        ]
      },
      {
        "type": "list",
        "ordered": false,
        "start": null,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "How to enable the Cypress integration for Microsoft Teams"
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "How to configure Microsoft Teams notifications for your Cypress Cloud organization and projects"
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "How to manage Microsoft Teams notifications at the organization and project level"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "The Microsoft Teams integration allows you to see your Cypress test results\ndirectly in your Microsoft Teams channels."
          }
        ]
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "Enable the Microsoft Teams integration"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "Ownership Requirements"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "In order to enable the Cypress integration for Microsoft Teams, you must be an\nadmin or owner of both your Cypress Cloud organization and your Microsoft Teams\nworkspace."
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Per-organization configuration (all projects)"
          }
        ]
      },
      {
        "type": "list",
        "ordered": true,
        "start": 1,
        "spread": true,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Go to Cypress Cloud\n"
                  },
                  {
                    "type": "link",
                    "title": null,
                    "url": "https://cloud.cypress.io/organizations",
                    "children": [
                      {
                        "type": "text",
                        "value": "Organizations page"
                      }
                    ]
                  },
                  {
                    "type": "text",
                    "value": " or open the\norganization switcher."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Select the organization you wish to integrate with Microsoft Teams."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Visit the selected organization's Integrations page via the side\nnavigation."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Click the Enable button in the Microsoft Teams section."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": true,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "You'll navigate to a window that manages webhooks as a way for Cypress Cloud\nto communicate with Microsoft Teams. First, you must configure an Incoming\nWebhook to a Teams channel."
                  }
                ]
              },
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "In Microsoft Teams:"
                  }
                ]
              },
              {
                "type": "list",
                "ordered": false,
                "start": null,
                "spread": true,
                "children": [
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Open the channel in which you want to add the webhook and select •••\nfrom the upper-right corner."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Select Connectors from the dropdown menu."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Search for Incoming Webhook and select Configure. Provide a name, and\nupload an image for your webhook if necessary."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Copy and save the unique webhook URL present in the dialog. The URL maps to\nthe channel and you can use it to send information to Teams."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": true,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Select Done."
                          }
                        ]
                      },
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "The webhook is now available in the Teams channel. For more information,\nsee\n"
                          },
                          {
                            "type": "link",
                            "title": null,
                            "url": "https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=dotnet#create-incoming-webhooks-1",
                            "children": [
                              {
                                "type": "text",
                                "value": "Microsoft Teams - Create Incoming Webhooks"
                              }
                            ]
                          },
                          {
                            "type": "text",
                            "value": "."
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": true,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Then, add the Teams webhook to your Cypress Cloud Organization."
                  }
                ]
              },
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "In Cypress Cloud:"
                  }
                ]
              },
              {
                "type": "list",
                "ordered": false,
                "start": null,
                "spread": false,
                "children": [
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Paste in the Teams webhook URL, choosing the types of notifications your\nteam should receive."
                          }
                        ]
                      }
                    ]
                  }
                ]
              },
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Once you've configured and added your webhooks, the installation is complete!\nCypress Cloud will post run results for all projects in your organization\nto the specified Microsoft Teams channel."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 4,
        "children": [
          {
            "type": "text",
            "value": "Remove a webhook"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "You can have Cypress Cloud stop posting notifications to a channel. You cannot\ndelete the global notification channels from a project."
          }
        ]
      },
      {
        "type": "list",
        "ordered": true,
        "start": 1,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Navigate to the Integrations page for the project with the installed\nintegration."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Scroll down to the Microsoft Teams section."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Under Actions, select Delete for each webhook you want deleted."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Per-project configuration"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "If your organization has multiple teams working on separate projects, you can\ntailor the Microsoft Teams notifications of each project to match your teams'\nneeds. You can have Cypress Cloud post run results for a specific project."
          }
        ]
      },
      {
        "type": "list",
        "ordered": true,
        "start": 1,
        "spread": true,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Select your organization in the organization switcher."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Select the project you wish to integrate with Microsoft Teams."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Go to the project's settings page."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Scroll down and click Add Teams webhook in the Microsoft Teams\nsection."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": true,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "You'll navigate to a window that manages webhooks as a way for Cypress Cloud\nto communicate with Microsoft Teams. First, you must configure an Incoming\nWebhook to a Teams channel."
                  }
                ]
              },
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "In Microsoft Teams:"
                  }
                ]
              },
              {
                "type": "list",
                "ordered": false,
                "start": null,
                "spread": true,
                "children": [
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Open the channel in which you want to add the webhook and select •••\nfrom the upper-right corner."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Select Connectors from the dropdown menu."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Search for Incoming Webhook and select Configure. Provide a name, and\nupload an image for your webhook if necessary."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Copy and save the unique webhook URL present in the dialog. The URL maps to\nthe channel and you can use it to send information to Teams."
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "type": "listItem",
                    "spread": true,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Select Done."
                          }
                        ]
                      },
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "The webhook is now available in the Teams channel. For more information,\nsee\n"
                          },
                          {
                            "type": "link",
                            "title": null,
                            "url": "https://learn.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook?tabs=dotnet#create-incoming-webhooks-1",
                            "children": [
                              {
                                "type": "text",
                                "value": "Microsoft Teams - Create Incoming Webhooks"
                              }
                            ]
                          },
                          {
                            "type": "text",
                            "value": "."
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": true,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Then, add the Teams webhook to your Cypress Cloud Project."
                  }
                ]
              },
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "In Cypress Cloud:"
                  }
                ]
              },
              {
                "type": "list",
                "ordered": false,
                "start": null,
                "spread": false,
                "children": [
                  {
                    "type": "listItem",
                    "spread": false,
                    "checked": null,
                    "children": [
                      {
                        "type": "paragraph",
                        "children": [
                          {
                            "type": "text",
                            "value": "Paste in the Teams webhook URL, choosing the types of notifications your\nteam should receive."
                          }
                        ]
                      }
                    ]
                  }
                ]
              },
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Once you've configured and added your webhooks, the installation is complete!\nCypress Cloud will post run results for this project to the specified\nMicrosoft Teams channel."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 2,
        "children": [
          {
            "type": "text",
            "value": "Notification preferences"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "By default, Cypress Cloud will post a Teams message to each configured channel\nonly for failing runs. However, you can select any combination of the followings preferences:"
          }
        ]
      },
      {
        "type": "list",
        "ordered": false,
        "start": null,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Failed runs: will notify on runs with a failed status."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Passed runs: will notify on runs with a passed status."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Flaky tests: will notify on runs that have an identified flaky test."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "To set notification preferences:"
          }
        ]
      },
      {
        "type": "list",
        "ordered": true,
        "start": 1,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Navigate to Teams configuration page"
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Select the notification preferences for each channel"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Filter notifications by tag or run group"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "When configuring at the project-level, you can filter notifications posted to Teams based on a\n"
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/app/references/command-line.md#cypress-run-tag-lt-tag-gt",
            "children": [
              {
                "type": "text",
                "value": "tag"
              }
            ]
          },
          {
            "type": "text",
            "value": " or\n"
          },
          {
            "type": "link",
            "title": null,
            "url": "/llm/markdown/app/references/command-line.md#cypress-run-group-lt-name-gt",
            "children": [
              {
                "type": "text",
                "value": "group"
              }
            ]
          },
          {
            "type": "text",
            "value": " the run was\nrecorded with. This can be helpful to only post notifications on certain runs,\nlike those to a staging or release environment."
          }
        ]
      },
      {
        "type": "list",
        "ordered": true,
        "start": 1,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Navigate to the Teams configuration page"
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Under Tags, select the Tag dropdown for the desired integration and\nselect which tag(s) to filter. If more than one tag is selected the Teams message will be sent\nif any of the tags were associated with the run."
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Under Run Groups, select the Run Group dropdown for the desired integration and\nselect which run group(s) to filter. If more than one run group is selected the Teams message will be\nsent if any of the run groups were associated with the run."
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "If both a tag and run group are selected, only a run associated with both criteria will\ntrigger a message to be sent to Teams."
          }
        ]
      },
      {
        "type": "heading",
        "depth": 3,
        "children": [
          {
            "type": "text",
            "value": "Mute a channel"
          }
        ]
      },
      {
        "type": "paragraph",
        "children": [
          {
            "type": "text",
            "value": "If you want Cypress Cloud to temporarily stop posting Teams messages to a\ncertain channel, you can Mute that channel. This allows you to easily pause\nand resume notifications for a specific channel without losing the configuration\nyou've put in place."
          }
        ]
      },
      {
        "type": "list",
        "ordered": true,
        "start": 1,
        "spread": false,
        "children": [
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Navigate to the Teams configuration page"
                  }
                ]
              }
            ]
          },
          {
            "type": "listItem",
            "spread": false,
            "checked": null,
            "children": [
              {
                "type": "paragraph",
                "children": [
                  {
                    "type": "text",
                    "value": "Toggle the Active selector for each Teams channel you want muted."
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "token_estimate": 1297
}