Skip to content

Clarify workflow creation steps and inline Slack install #4489

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ethanpalm merged 5 commits into from
Mar 16, 2026
Merged

Clarify workflow creation steps and inline Slack install #4489

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
f21ca8a
Clarify workflow creation steps and inline Slack install flow
mintlify[bot] Mar 15, 2026
8f99dd9
Apply suggestion from @ethanpalm
ethanpalm Mar 16, 2026
37037e0
Apply suggestion from @ethanpalm
ethanpalm Mar 16, 2026
35c3b43
Apply suggestion from @ethanpalm
ethanpalm Mar 16, 2026
303e5b0
Merge branch 'main' into mintlify/workflow-slack-install-1773597943
ethanpalm Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions agent/workflows.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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**.

<Frame>
<img src="/images/agent/new-workflow-light.png" alt="The new workflow setup page." className="block dark:hidden" />
Expand Down Expand Up @@ -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.

<Note>
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).
</Note>

#### 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.

Expand Down
Loading