> For the complete documentation index, see [llms.txt](https://docs.snyk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snyk.io/scan-fix-and-prevent/scan-with-snyk/snyk-api-web/integrations/collaborate/integrate-with-slack.md).

# Integrate with Slack

By connecting Snyk API & Web with Slack, you receive notifications about the activity of your targets in your Slack channels. For example, when target scans start or finish, when logins fail, or when Snyk finds or fixes vulnerabilities.

This integration involves two steps:

1. Configure the webhook in Slack.
2. Configure the Slack webhook in Snyk API & Web.

This article describes these steps in detail.

## Configure the webhook in Slack

Configure a webhook in Slack with a channel to receive notifications from Snyk:

1. Log in to your Slack account at `https://slack.com/signin` and select your Slack workspace.
2. Navigate to `https://api.slack.com/apps` and do the following:
   1. If this is your first app, click **Create an App**. Otherwise, click **Create New App**.
   2. In the displayed dialog, click **From Scratch**.
3. In the next dialog, fill out the form as follows:
   1. In the **App name**, enter a meaningful name. For example: "Snyk API & Web Integration".
   2. In the dropdown, select the Slack workspace you want to receive Snyk notifications.
   3. Click **Create App**. Slack redirects you to the **Basic Information** page.
4. In the sidebar menu, select **Incoming Webhooks**. If it is not turned on, click the toggle button of **Activate Incoming Webhooks** to turn it on.
5. Scroll to the bottom of the page and click **Add New Webhook to Workspace**.
6. On the displayed page, click the dropdown to see the list of Slack channels, select the one you want to receive Snyk notifications (for example, "Snyk API & Web notifications"), and click **Allow**.
7. Return to **Incoming Webhooks**, scroll down, and validate the newly created webhook.
8. Click **Copy** to store the webhook URL in the clipboard. You need it to configure the Slack integration in Snyk.

You have configured the webhook on the Slack side. Now move on to the Snyk side.

## Configure the Slack webhook in Snyk API & Web

Configure the Slack webhook on the target for which you want to receive notifications about its activity:

1. In the Snyk API & Web application, navigate to **Targets** and click the **gear icon** of the row of the target you want to configure.
2. Click the **Integrations** tab, navigate to the **Slack** section, and set the **Slack webhook URL**. If you copied the URL to the clipboard at the end of the previous step, paste it.
3. Select which events you want to be notified about. For example, target scan events such as when scans start and end, when they identify high-severity vulnerabilities, and when they fail to log in.
4. Click **Save** to conclude the Slack integration for the target.

After you integrate a target with Slack, you start receiving notifications from Snyk about the target's activity in your Slack channel. For example:

This integration lets you adjust notifications to the needs of your company. For example, you can use a single Slack webhook to configure your targets and receive all notifications in the same Slack channel. If necessary, you can create more webhooks and configure your targets so that you receive notifications of different targets, or groups of targets, in different Slack channels.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.snyk.io/scan-fix-and-prevent/scan-with-snyk/snyk-api-web/integrations/collaborate/integrate-with-slack.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.