> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Vortex Staging notifications

> Configure Vortex Staging notifications across Email, Slack incoming webhooks, and Microsoft Teams workflows so the right people are alerted when a Shopify migration or theme deployment completes.

Vortex Staging supports three notification channels: Email, Slack, and Microsoft Teams. Configure them under Settings, Status Notifications. Each channel is independent; you can enable any combination.

This page consolidates the V1 setup guides for all three channels into a single reference.

<h2 id="email">
  Email \\
</h2>

Email notifications are a simple way to alert stakeholders when environment status changes occur or migrations complete.

To set up email notifications, navigate to Settings and select Status Notifications.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Email1.png" alt="Status Notifications settings" />

Enter an email address in the Email Notification field and click Add. Repeat for any additional recipients. When ready, click Send Test Email and Save, enter a short message, and click Send. You should receive the test email in the inboxes you added.

<h2 id="slack">
  Slack \\
</h2>

Communication between team members is vital in any development project, and keeping in touch with teams working remotely and across different time zones is more important than ever. Vortex Staging has the native ability to send notifications to Slack each time a deployment event occurs.

Slack integration is supported through Incoming Webhooks. Once configured, Vortex Staging can post status messages into a chosen Slack channel.

Before you begin, create a Slack workspace (if needed) and a channel where notifications should be delivered. You will then create a Slack App and enable Incoming Webhooks for it.

### Slack setup steps

#### Step 1. api.slack.com

From a new browser tab, go to api.slack.com.

#### Step 2. Your apps

Click Your apps on the top right.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack01.png" alt="api.slack.com Your apps" />

#### Step 3. Sign in

Click the Go to Slack button on the top right to sign in to your Slack account.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack02.png" alt="Go to Slack button" />

#### Step 4. Sign in screen

Sign in to your Slack account.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack03.png" alt="Slack sign in" />

#### Step 5. Create a workspace

Click Create a workspace, enter your company or team name, then click Next.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack04.png" alt="Create a workspace" />

#### Step 6. Name

Enter your name.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack05.png" alt="Enter name" />

#### Step 7. Coworkers

Invite coworkers by entering their email addresses and click Next. You may also skip this step.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack06.png" alt="Invite coworkers" />

#### Step 8. Workspace details

Enter the necessary details (for example, a workspace name such as Testing) and click Next. Your workspace is ready.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack07.png" alt="Workspace details" />

#### Step 9. Channel created

The testing channel will be created and is ready for communication.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack08.png" alt="Channel ready" />

#### Step 10. Enable webhook

To enable the webhook, go back to api.slack.com, click Your apps, then click Create an App.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack09.png" alt="Create an App" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack10.png" alt="Create an App popup" />

#### Step 11. From scratch

When the Create an app window appears, select From scratch.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack11.png" alt="From scratch" />

#### Step 12. Name and workspace

Give your app a name and choose your company's Slack workspace from the dropdown. If the workspace dropdown is empty, return to api.slack.com and ensure you are signed in to Slack.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack12.png" alt="Name and workspace" />

#### Step 13. Activate Incoming Webhooks

Click Create App, then select Incoming Webhooks from the left menu. Switch Activate Incoming Webhooks to On, then click Add New Webhook to Workspace.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack13.png" alt="Activate Incoming Webhooks" />

#### Step 14. Grant permissions

Click Add new webhook to the workspace and grant permissions. The webhook will be created.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack14.png" alt="Grant permissions" />

#### Step 15. Select channel

When prompted, select the channel you created and click Allow.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack15.png" alt="Select channel" />

#### Step 16. Copy webhook URL

Copy the generated webhook URL using the Copy button.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack16.png" alt="Copy webhook URL" />

#### Step 17. Add URL to Vortex Staging

Paste the copied webhook URL into Vortex Staging under Settings, Status Notifications, Slack, then click Add.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack17.png" alt="Paste webhook URL" />

Enter the test message and click Send.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack18.png" alt="Test message" />

A confirmation message will be displayed indicating successful delivery.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack19.png" alt="Successful delivery" />

#### Step 18. Verify in Slack

Open Slack and navigate to the channel used for the webhook. You should see the notification message posted there.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Slack20.png" alt="Notification in Slack" />

<h2 id="teams">
  Microsoft Teams \\
</h2>

Microsoft Teams integration is supported using Teams Workflows. Once configured, Vortex Staging can post notifications directly into the selected Teams channel.

### Teams setup steps

In the new Teams client, select Teams and navigate to the channel where you want to receive notifications.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Teams01.png" alt="Teams channel selection" />

Select More options on the right of the channel name and click Workflows. Click "Post to a channel when a webhook request is received".

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Teams02.png" alt="Post to channel workflow" />

Enter the name of the workflow and click Next.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Teams03.png" alt="Workflow name" />

Click Add workflow.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Teams04.png" alt="Add workflow" />

Copy and save the unique workflow URL shown in the dialog. This URL maps to the channel and is used by Vortex Staging to send messages. Select Done.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Teams05.png" alt="Workflow URL" />

Paste the copied workflow URL in Vortex Staging under Settings, Status Notifications, Teams, then click Add.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/vortexiq/vortex-apps/vortex-staging/images/Teams06.png" alt="Paste URL in Vortex Staging" />

## Which channel should I use

Most teams configure all three. The pattern that works in practice:

* **Email** for stakeholders who need a record but do not live in a chat tool (executives, finance reviewers).
* **Slack** for the developer team running deploys; webhook events arrive instantly.
* **Microsoft Teams** for the broader business team where Slack is not the primary chat tool.

You can mix and match. There is no charge per channel; the only cost is the time to configure each.

## FAQ

### Can I route different events to different channels?

Currently, all enabled channels receive all notification events (migration started, migration completed, migration failed, deploy approved, deploy completed, deploy failed). Per-event routing is on the roadmap.

### What happens if my Slack workspace deletes the webhook?

Vortex Staging will start logging delivery failures. Re-create the webhook in Slack and update the URL in Vortex Staging under Settings, Status Notifications, Slack.

### Can I receive notifications via SMS?

Not natively. Most teams hook the Slack or Teams channel into a paging tool (PagerDuty, Opsgenie) that handles SMS escalation.

## Related pages

* [Onboarding](/vortex-apps/vortex-staging/onboarding), notifications fit into the Step 5 setup
* [Theme deployments](/vortex-apps/vortex-staging/theme-deployments), the events that trigger deploy notifications
* [Migration history](/vortex-apps/vortex-staging/migration-history), the events that trigger migration notifications
* [GitHub deployment](/vortex-apps/vortex-staging/github-deployment), GitHub deploy events also trigger notifications