Notifications through Slack, Microsoft Teams, or Webhook

Set up notification alerts for your Web and Feature experiments or for individual feature flags. Amplitude offers two notification delivery paths:

• Email or Slack direct messages: Notifications for Experiments (Web and Feature) about to start or end, when Amplitude detects a sample-ratio mismatch (SRM), or when the experiment's recommendation metric reaches statsig.
• Slack channels, Microsoft Teams channels, webhooks, or email: Notifications for changes to an active flag configuration that generate a new history version, or when you activate or deactivate flags.

This page covers notification alerts delivered through Slack channels, Microsoft Teams channels, webhooks, and email. Amplitude delivers only alerts created through the Experiment Alerts function this way.

Amplitude delivers all other experiment alerts through email or Slack direct message. For more information on those notification types, go to Account Settings Notifications, Integrate Slack, or Integrate Microsoft Teams to manage your workspace integrations.

If you use Google Chat, send an email or webhook.

To integrate your Amplitude flags and experiments with Sentry, refer to Sentry's documentation.

Connect a Slack workspace to your experiment notifications

1. Go to Experiment and then click Experiments. You can also access alerts by going to Settings > Personal settings > Experiment and clicking Add alert, or Settings > Organization settings > Experiment and clicking Add alert.
2. Click Alerts in the top right.
3. Click Connect To Slack.
4. Click Allow to confirm that you want to connect Amplitude to Slack.

Connect Microsoft Teams to your experiment notifications

To deliver experiment alerts to a Microsoft Teams channel, your organization must connect Amplitude to Microsoft Teams. If the connection doesn't exist, the alert creation modal shows a Connect to Microsoft Teams action that starts the connection flow.

For setup steps, go to Integrate Microsoft Teams with Amplitude.

Change alerts

Change alerts notify you when flag or experiment configurations change. Amplitude generates an alert any time a change creates a new history version, or when you activate or deactivate flags.

Experiment activities that generate alerts

Specify which experiment activities trigger alerts:

• Flags created, updated, or deleted.
• Targeting rule changes (for example, updates to target segments or bucketing settings).
• Variant changes.
• Flag activation or deactivation.

Set up an alert

After you connect your Slack workspace or Microsoft Teams organization to Amplitude, you can create notifications for your experiments.

To send notifications through webhooks, provide the URL and a valid signing key when you create the alert.

Webhook schema:

{
  "flagId": number
  "flagName": string (This is the flag key and not the flag name. If you want the flag name, use `flag.name`)
  "scope": "exp_deployment" | "project" | "exp_tags"
  "scopeParam": number | undefined
  "scopeParamName": string | undefined
  "action": "created" | "deleted" | "updated"
  "modifiedBy": string
  "flag": JSON
  "oldFlag": JSON
  }

Create an alert

1. From the Amplitude home page, go to the Experiment section and click Experiments. You can also access alerts by going to Settings > Personal settings > Experiment and clicking Add alert, or Settings > Organization settings > Experiment and clicking Add alert.
2. Click Alerts in the top right.
3. Specify the project.
4. Set the scope. Select one of:
   • All In the Project: Notifications for all experiments and flags in the project.
   • By Deployment: Notifications for all experiments and flags in the deployment. Specify the deployment by label. For more information, go to Deployments. Web Experiments and Guides & Surveys experiments use the Project API Key deployment.
   • By Tag: Notifications only for experiments and flags tagged with specific labels.
5. Choose the delivery channel:
   • For Slack, click the dropdown to choose the channel for your alerts.
   • For Microsoft Teams, click the dropdown to choose the team and channel for your alerts.
   • For a webhook, enter the URL and your signing key.
   • For email, enter an email address.
6. Name your alert.
7. Click Create Alert.