From 432c4cb8e894f436c2337cee491b24e0c0705f40 Mon Sep 17 00:00:00 2001 From: Amber Alston Date: Tue, 24 Mar 2026 10:33:26 -0600 Subject: [PATCH 1/3] docs: update Slack webhook integration to use modern custom Slack app approach The previous instructions referenced the deprecated standalone Incoming WebHooks Slack app. Updates steps to guide users through creating a custom Slack app with incoming webhooks enabled, links to the current Slack docs domain, and adds a tip for multi-channel routing. Co-Authored-By: Claude Opus 4.6 --- docs/vendor/event-notifications-webhooks.mdx | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/vendor/event-notifications-webhooks.mdx b/docs/vendor/event-notifications-webhooks.mdx index 4ee837069a..ed97684ef4 100644 --- a/docs/vendor/event-notifications-webhooks.mdx +++ b/docs/vendor/event-notifications-webhooks.mdx @@ -150,17 +150,21 @@ 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 Event Notifications to Slack, you create a Slack app with incoming webhooks enabled and 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](https://api.slack.com/apps/new) for your workspace, or use an existing one. +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. +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. +:::tip +To send different events to different Slack channels, repeat step 3 to generate a separate webhook URL for each target channel within the same Slack app. Then use the appropriate webhook URL when creating each Event Notification subscription. +::: + ## Test webhooks locally {#test-webhook} You can test a webhook locally using a development endpoint that is either publicly accessible, or reachable through a secure tunnel. From 2d9780ca9de9ce69fd781a26b6c8eba73ad4c46d Mon Sep 17 00:00:00 2001 From: Amber Alston Date: Tue, 24 Mar 2026 10:39:36 -0600 Subject: [PATCH 2/3] docs: change tip to note for consistency with rest of docs Co-Authored-By: Claude Opus 4.6 --- docs/vendor/event-notifications-webhooks.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/vendor/event-notifications-webhooks.mdx b/docs/vendor/event-notifications-webhooks.mdx index ed97684ef4..db262649e6 100644 --- a/docs/vendor/event-notifications-webhooks.mdx +++ b/docs/vendor/event-notifications-webhooks.mdx @@ -161,7 +161,7 @@ To send notifications to a Slack channel using webhooks: 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. -:::tip +:::note To send different events to different Slack channels, repeat step 3 to generate a separate webhook URL for each target channel within the same Slack app. Then use the appropriate webhook URL when creating each Event Notification subscription. ::: From 0eb56e808f0455ab66745db58513ca4f092ee4c9 Mon Sep 17 00:00:00 2001 From: Paige Calvert Date: Tue, 24 Mar 2026 11:51:49 -0600 Subject: [PATCH 3/3] docs edits --- docs/vendor/event-notifications-webhooks.mdx | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/vendor/event-notifications-webhooks.mdx b/docs/vendor/event-notifications-webhooks.mdx index db262649e6..442d7870ba 100644 --- a/docs/vendor/event-notifications-webhooks.mdx +++ b/docs/vendor/event-notifications-webhooks.mdx @@ -150,21 +150,20 @@ To verify webhook signatures in your endpoint: ## Integrate with Slack using webhooks -To send Event Notifications to Slack, you create a Slack app with incoming webhooks enabled and 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 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. [Create a Slack app](https://api.slack.com/apps/new) for your workspace, or use an existing one. +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. + ::: 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. -:::note -To send different events to different Slack channels, repeat step 3 to generate a separate webhook URL for each target channel within the same Slack app. Then use the appropriate webhook URL when creating each Event Notification subscription. -::: - ## Test webhooks locally {#test-webhook} You can test a webhook locally using a development endpoint that is either publicly accessible, or reachable through a secure tunnel.