Notifications through Slack Channel or Webhook

This article helps you:

  • Understand the type of notifications you can set for experiments

  • Create notification alerts for your experiments

Set up notification alerts for your Web and Feature experiments or for individual feature flags. There are two ways to receive notifications for different types of events:

  • Email / Slack direct messages: Sends notifications for Experiments (Web and Feature) about to start or end, if a sample-ratio mismatch (SRM) is detected, or a statsig for a recommendation metric reached.
  • Slack channel notifications / webhooks: Sends notifications for any changes to an active flag configuration that generates a new history version or when flags are activated or deactivated.

This page discusses setting up and maintaining notification alerts through Slack channels and webhooks. Only notifications created through the Experiment Alerts function are sent in this way.

All other experiment alerts are sent either through email or Slack direct message. For more information on these other types of notification, go to Account Settings Notifications or Integrate Slack to know how to manage your Slack workspace integration.

Note

You must have Member permissions to create/edit/delete any notification alerts. You don't need any permissions to receive notifications if you also a member of the dedicated slack channel or webhook. However, you must have Viewer permissions to open the notification for more details. Talk to your Admin if you need different permissions.

To connect a Slack workspace to your experiment notifications

You only need to connect your Slack workspace to your experiment notifications once.

  1. Go to Experiment and then click Experiments.
    You can also access alerts by going to Settings > Organization settings > Experiment and then 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.

Note

If you see a slack channel id instead of a slack channel name, make sure you have connected Amplitude and Slack. If you have already done that then make sure you are a member of the slack channel. You can reach out to the person who created the alert (which is in the "created" column of the table) to add you to the slack channel.

Experiment activities that generate alerts

You can specify if you want to receive alerts for the following experiment activities:

  • Flags created, updated, or deleted

Setting up an alert

After you have connected your Slack organization to Amplitude, you can create notifications for your experiments.

If you want to send notifications through webhooks, you must provide the URL and valid signing key. You can specify your webhook at the same time that 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
  }

JSON Schemas

View the JSON schema for the flag and oldFlag parameters in the Experiment Management API Flag Endpoints documentation.

To set up an alert
  1. Go to Experiment and then click Experiments.
    You can also access alerts by going to Settings > Organization settings > Experiment and then clicking Add alert.
  2. Click Alerts in the top right.
  3. Specify the project that you want.
  4. Set the scope. You can select one of:
    • All In the Project: Receive notifications for all experiments and flags in the project.
    • By Deployment: Receive notifications for all experiments and flags in your entire deployment.
      If you are receiving alerts by deployment, you must specify the deployment by the label. Go to Deployments for more information. Remember that Web Experiments and Guides and Surveys experiments have the Project API Key deployment.
    • By Tag: Receive notifications only for experiments and flags tagged with specific labels.
  5. Choose how you want to receive your notifications:
    • If you're using Slack, click the dropdown to choose the channel for your alerts.
    • If you're using a Webhook, enter the URL and your signing key.
  6. Name your alert.
  7. Click Create Alert.
Was this page helpful?

July 29th, 2025

Need help? Contact Support

Visit Amplitude.com

Have a look at the Amplitude Blog

Learn more at Amplitude Academy

© 2025 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.