This guide walks you through creating a Slack Incoming Webhook and configuring Synqly's **Slack Incoming Webhook** notifications provider (`notifications_slack_webhook`).

## Prerequisites

Before you begin, ensure that you have:

- Access to a Slack workspace where you can create apps (or an existing Slack app you can edit)
- Permission to add an Incoming Webhook for the target channel
- The Slack channel that should receive Synqly notifications


## 1. Create a Slack App

1. Go to [Slack API: Your Apps](https://api.slack.com/apps) and sign in.
2. Click **Create New App**.
3. Choose **From scratch**.
4. Enter an **App Name** (for example, `Synqly Notifications`).
5. Select your **workspace**, then click **Create App**.


## 2. Enable Incoming Webhooks

1. In the left sidebar, open **Incoming Webhooks** (under **Features**).
2. Set **Activate Incoming Webhooks** to **On**.


You do **not** need Bot Token OAuth scopes for this provider. Incoming Webhooks authenticate with the webhook URL itself.

## 3. (Optional) Add Collaborators

To avoid losing access if the creating account is deactivated, open **Settings** → **Collaborators** and add additional workspace members who should manage the app.

## 4. Create a Webhook URL for Your Channel

1. Still on the **Incoming Webhooks** page, click **Add New Webhook to Workspace**.
2. Select the Slack **channel** that should receive Synqly notifications (public or private).
3. Click **Allow**.
4. Copy the generated **Webhook URL**. It looks like:
`https://hooks.slack.com/services/T.../B.../...`


Treat the webhook URL as a secret. Anyone with the URL can post messages to that channel. Do not commit it to source control or share it in tickets/chat.

The channel is fixed when the webhook is created. To post to a different channel, create another webhook (or regenerate) and update the Synqly integration.

For more detail, see Slack's [Incoming Webhooks](https://api.slack.com/messaging/webhooks) documentation.

## 5. Configure the Integration

Create your Synqly notifications integration using the **Slack Incoming Webhook** provider and supply:

| Integration Parameter | Description |
|  --- | --- |
| Incoming Webhook URL | The full webhook URL copied in step 4 (for example, `https://hooks.slack.com/services/...`) |


There is no separate channel field, bot token, or base URL for this provider. The destination channel is determined by the webhook URL.