> For the complete documentation index, see [llms.txt](https://docs.widgelix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.widgelix.com/notifications/types/slack.md).

# Slack

## Sending messages using incoming webhooks

Incoming webhooks are a way to post messages from **Widgelix** into **Slack**. Creating an incoming webhook gives you a unique URL to which you send your notifications. You can use all the usual [formatting](https://api.slack.com/reference/surfaces/formatting) to make the messages stand out.

The setup is straightforward - you create a Slack App and then use it to generate a unique webhook URL. Follow the steps in this article to obtain the URL for **Slack** notifications.

### Create a Slack app (if you don't have one already)  <a href="#create-app" id="create-app"></a>

[Create your Slack app](https://api.slack.com/apps/new)

Pick a name, choose a workspace to associate your app with (bear in mind you'll probably be posting lots of test messages, so you may want to create a channel for sandbox use), then click **Create New App** and choose **from scratch**. If you've already created an app, you can use that one.

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FOs6IwLp9HugnMvAxB2y0%2Fimage.png?alt=media&amp;token=784e2097-2e0f-4104-b3d5-78f26155e683" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FsPxFxlGd9Q8TxJM1njvg%2Fimage.png?alt=media&amp;token=b9d6bddf-e5cd-41bf-97ec-9f4b42ff551f" alt=""><figcaption></figcaption></figure>

### Enable incoming webhooks  <a href="#enable_webhooks" id="enable_webhooks"></a>

You'll be redirected to the settings page for your new app (if you're using an existing app, you can load its settings via your [app's management dashboard](https://api.slack.com/apps)).

From here, select **Incoming Webhooks**, and toggle **Activate Incoming Webhooks** to on.

### Create an incoming webhook  <a href="#create_a_webhook" id="create_a_webhook"></a>

Now that incoming webhooks are enabled, the settings page should refresh and some additional options will appear. One of those options is a very helpful button called **Add New Webhook to Workspace** — click it!

What this button does is trigger a shortcut version of the installation flow for Slack apps, one that is completely self-contained so that you don't have to actually build any code to generate an incoming webhook URL. You'll see something like the following:

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FJan34FQ3u8HSIERmUXyT%2Fimage.png?alt=media&amp;token=bff39dea-a775-446c-ae22-ca6269a977d6" alt=""><figcaption></figcaption></figure>

Go ahead and pick a channel that the app will post to, then select **Authorize**. If you need to add the incoming webhook to a private channel, you must first be in that channel.

You'll be sent back to your app settings, where you should see a new entry under the **Webhook URLs for Your Workspace** section. Your webhook URL will look something like this:

```http
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
```

That URL is your new incoming webhook, one that's specific to a single user and a single channel.

Let's see how you can actually use that webhook to post a message.

<mark style="color:orange;">**Keep it secret, keep it safe**</mark><mark style="color:orange;">. Your webhook URL contains a secret. Don't share it online, including via public version control repositories.</mark> <mark style="color:orange;"></mark><mark style="color:orange;">**Slack actively searches out and revokes leaked secrets.**</mark>

### Using webhook URL in you Widgelix's Rule

Go to your created rule, and paste your Slack Webhook URL into URL field of Slack notification option:

<figure><img src="https://2494440469-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fggsr9Xlsze5cwVr4WMof%2Fuploads%2FpFQuYVODZv4y6QznvrWC%2Fimage.png?alt=media&amp;token=ac074113-5fc0-4937-9b0d-1df580ec6495" alt=""><figcaption></figcaption></figure>
