diff --git a/agent/workflows.mdx b/agent/workflows.mdx
index 2a9ba6c75..7c35c67dc 100644
--- a/agent/workflows.mdx
+++ b/agent/workflows.mdx
@@ -27,9 +27,10 @@ Use workflows that run on push events to automate reactive maintenance tasks lik
1. Open the [Workflows](https://dashboard.mintlify.com/products/workflows) page.
2. Click **New workflow**.
-3. Configure the trigger, prompt, and other settings.
-4. Optionally, enable Slack notifications to notify channels when the workflow completes. See [Slack notifications](#slack-notifications).
-5. Click **Create workflow**.
+3. Configure the workflow name, trigger type, repositories, and schedule.
+4. Write the agent instructions and choose whether to auto-merge pull requests.
+5. Optionally, enable Slack notifications for when the workflow completes.
+6. Click **Create workflow**.
@@ -166,15 +167,15 @@ automerge: true
Send Slack messages when a workflow completes or fails. Notifications include the workflow status, a link to the pull request, and a summary of the changes.
-Slack notifications require a Slack installation on your organization. Connect Slack on your [dashboard](https://dashboard.mintlify.com/products/agent).
+Slack notifications require the Mintlify Slack app in your organization's Slack workspace. Install the Slack app from your [dashboard](https://dashboard.mintlify.com/products/agent).
#### Configure Slack notifications in the dashboard
When creating or editing a workflow in the dashboard, you can enable Slack notifications under the **Notify on completion** toggle:
-1. If you haven't connected Slack yet, click **Install slack app** to connect your Slack workspace directly from the workflow page.
-2. Toggle **Notify on completion** to enable Slack notifications.
+1. If you haven't connected Slack, click **Install slack app**.
+2. Click the **Notify on completion** toggle.
3. Search for and select the channels you want to notify.
4. Save your workflow.