> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-platform/3.0/harness-platform-resources/triggers/trigger-pipelines-using-slack-events.md).

# EventRelay Slack Webhook triggers

Trigger Pipelines Using Slack Events

You can trigger pipelines in response to Slack messages or events that match specific payload conditions you set up in a Harness trigger. For example, when a specific message is posted in a Slack channel or a particular event occurs, and your trigger settings match the payload conditions, a CI or CD pipeline can run.

Triggers enable event-driven CI/CD and support practices like building and/or deploying with every relevant Slack interaction.

{% hint style="info" %}
**NOTE**

Currently this feature is behind the Feature Flag `CDS_EVENT_BRIDGE_WEBHOOK` and `CD_TRIGGERS_REFACTOR`. Please contact [Harness Support](mailto:support@harness.io) to enable this feature.
{% endhint %}

### Add a trigger to a pipeline <a href="#add-a-trigger-to-a-pipeline" id="add-a-trigger-to-a-pipeline"></a>

First, let’s configure a Slack webhook to create a trigger.

#### Configure a webhook <a href="#configure-a-webhook" id="configure-a-webhook"></a>

Steps to Create a Slack Webhook

1. Go to **Account**/**Project** settings and click on **Webhook** under Resources.
2. Click on **New Webhook**.
3. Enter a **Name** for the webhook.
4. Select the type of the webhook. In this case, **Slack**.
5. For Auth type, we have two options **No Auth** if you have authentication to your source. no additional configuration is required. **HMAC** for Hash-Based Message Authentication Code authentication

Now, click on **Add** to save webhook.

The webhook is now created, click on the webhook you created earlier and copy the **Webhook URL** provided.

#### Configure a trigger <a href="#configure-a-trigger" id="configure-a-trigger"></a>

To link this webhook to trigger your pipeline, navigate to the pipeline for which this webhook will be used.

1. Select **Triggers** in the top right corner of the page.
2. Click on **New Trigger** and select **Event Relay**.
3. On the configurations page, provide a **Name** for the webhook.
4. Under **Listen on New Webhook**, **Event Relay** is selected by default for **Payload Type**. When selecting Webhooks, a pop-up page will display all the configured Generic and Slack webhooks.

Select the Slack webhook you created earlier.

Click on **Continue**.

5. In the **Conditions** page, give the appropriate **Header Conditions** and **Payload Conditions**. Click on **Continue**.
6. In the **Pipeline Input** page, you can provide any Pipeline input variables as per your requirement. Click on **Create Trigger**

#### Configure Slack with the Webhook <a href="#configure-slack-with-the-webhook" id="configure-slack-with-the-webhook"></a>

This section explains how to configure Slack with your webhook to enable real-time notifications.

Follow these steps to integrate the webhook and set it up for bot events in your chosen channel:

1. Go to the [Slack website](https://api.slack.com/) on your browser.
2. After logging in, click on **Your Apps** located in the top-right corner of the page.
3. On the **Your Apps** page:
   * Select an existing app where you want to configure your webhook.
   * To create a new app, click **Create New App**. 1. Choose **From a manifest** if you want to use a manifest file to define the app's basic info, such as scope and settings: - Select the workspace where you want the app to be used. - Update the JSON content based on your requirements, such as the app's name, settings, etc. - Click **Create App**. 2. Choose **From scratch** to manually add the app name and workspace through the UI.
4. In the **Your Apps** page, under **Features** in the left navigation bar, go to **Event Subscriptions**.
5. Turn on **Enable Events**.
6. In the **Request URL** field, paste the webhook URL you configured earlier. The URL will be automatically verified to ensure it is valid.
7. Under the **Subscribe to Bot Events** section, add the events that should trigger the webhook. Click **Save Changes**.
8. Navigate to your Slack application and open the channel where you want the webhook to trigger events. In the channel settings, go to the **Integrations** tab and add the app you just created.

For more information, visit the [Slack Documentation](https://api.slack.com/apis/events-api).

Now that Slack is configured, any relevant Slack event in the configured channel will trigger the pipeline.