Skip to content

docs: update Slack webhook integration steps #3902

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
AmberAlston merged 3 commits into from
Mar 24, 2026
Merged

docs: update Slack webhook integration steps #3902

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
432c4cb
docs: update Slack webhook integration to use modern custom Slack app…
AmberAlston Mar 24, 2026
2d9780c
docs: change tip to note for consistency with rest of docs
AmberAlston Mar 24, 2026
0eb56e8
docs edits
paigecalvert Mar 24, 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: 8 additions & 5 deletions docs/vendor/event-notifications-webhooks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -150,14 +150,17 @@ To verify webhook signatures in your endpoint:

## Integrate with Slack using webhooks

For more information about configuring incoming webhooks with Slack, see the [Sending messages using incoming webhooks](https://api.slack.com/messaging/webhooks) in the Slack documentation.
To send notifications to Slack, enable incoming webhooks on a new or existing Slack app, and then use the generated webhook URL as your subscription endpoint. For more information about incoming webhooks, see [Sending messages using incoming webhooks](https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks) in the Slack documentation.

To send notifications to a Slack channel using webhooks:

1. Go to your Slack workspace settings.
1. Go to **Apps** > **Incoming Webhooks** and click **Add to Slack**.
1. Select the channel where you want to receive notifications.
1. Copy the webhook URL.
1. Create a Slack app for your workspace, or use an existing one. To use the Slack API to create an app, go to `https://api.slack.com/apps/new` in a browser.
1. In your Slack app settings, enable **Incoming Webhooks**.
1. Click **Add New Webhook to Workspace** and select the channel where you want to receive notifications.
:::note
You can send each notification to one Slack channel. To generate additional webhooks URLs to use for different event notifications, click **Add New Webhook to Workspace** again and select the target channel.
:::
Copy link
Contributor

@paigecalvert paigecalvert Mar 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

moved this note up in to the procedure and reworded a bit. lmk if this gets at what you were wanting to convey (that it's one channel per event notification and you can generate more URLs for other notifications)

1. Copy the generated webhook URL.
1. Create an Event Notification subscription in the Vendor Portal using your Slack webhook URL. See [Create an Event Notification](/vendor/event-notifications-create#create-an-event-notification).
1. Trigger a test event to verify that the webhook is configured properly.

Expand Down
Loading