> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/data-sinks/data-sink-integrations/send-data-to-slack.md).

# Send data to Slack

{% hint style="info" %}
See the changelog of the **Slack** Data sink type [here](/data-sinks-changelog/slack-data-sink.md).
{% endhint %}

## Overview

Onum supports integration with [Slack](https://slack.com/). 

Slack is a messaging app and platform designed to facilitate team collaboration and communication within organizations. It's a centralized hub for conversations, files, and tools, helping teams stay organized and connected. 

## Onum Setup

{% stepper %}
{% step %}
Log in to your Onum tenant and click **Data Sinks> New Data sink**.
{% endstep %}

{% step %}
Double-click the **Slack** Sink.
{% endstep %}

{% step %}
Enter a **Name** for the new Data Sink. Optionally, add a **Description** and some **Tags** to identify the Sink.
{% endstep %}

{% step %}
Decide whether or not to include this Data sink info in the metrics and graphs of the [**Home**](/home.md) area.
{% endstep %}

{% step %}
Enter the credentials to connect to your Slack environment, either:

**Slack API.** Find this in the [Apps Dashboard for Slack API](https://api.slack.com/apps) by creating a new Slack App.

1. Navigate to the **Your Apps** page: `https://api.slack.com/apps` and sign in to your Slack workspace.
2. Click on the name of the app you want to use.
3. In the left sidebar navigation, click on **OAuth & Permissions**.

   Your tokens will be displayed on this page under the "OAuth Tokens for Your Workspace" section.
4. Add the token as a [Secret](/settings/organization-settings/secrets-management.md) (see the next step for how to do this).

**Legacy Webhook**. 

1. Click **Create New App > From Scratch**.
2. Enter an App Name, select the workspace to develop your app in, and click **Create App**.
3. Activate the incoming webhooks option.
4. Select **Add New Webhook to Workspace**. Select the channel to post the newly created Slack app to and **allow**.
5. Copy the URL of your webhook in the Incoming Webhooks page.
   {% endstep %}

{% step %}
In the [Secrets](/settings/organization-settings/secrets-management.md) area, **New secret** to create a new one:

* Give the secret a **Name**.
* Turn off the **Expiration date** option.
* Click **Add new value** and paste the corresponding value.
* Click **Save**.

<figure><picture><source srcset="/files/NeeWsSQzoChVxRIY76Nt" media="(prefers-color-scheme: dark)"><img src="/files/1oTccyPmgZJ1laY7IhZH" alt=""></picture><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about secrets in Onum in [this article](/settings/organization-settings/secrets-management.md).
{% endhint %}

You can now select the created secrets in the configuration.
{% endstep %}

{% step %}
Establish a limit for the **Maximum requests per second**<mark style="color:red;">**\***</mark>. The minimum value is `1` and the maximum value is `10`.
{% endstep %}

{% step %}
If you are using a proxy to establish the connection, toggle on the **Proxy configuration** button and enter the details here.
{% endstep %}

{% step %}
In the [Secrets](/settings/organization-settings/secrets-management.md) area, **New secret** to create a new one:

* Give the secret a **Name**.
* Turn off the **Expiration date** option.
* Click **Add new value** and paste the corresponding value.
* Click **Save**.

<figure><picture><source srcset="/files/NeeWsSQzoChVxRIY76Nt" media="(prefers-color-scheme: dark)"><img src="/files/1oTccyPmgZJ1laY7IhZH" alt=""></picture><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about secrets in Onum in [this article](/settings/organization-settings/secrets-management.md).
{% endhint %}

You can now select the created secrets in the configuration.
{% endstep %}
{% endstepper %}

Click **Finish** when complete. Your new Data sink will appear in the **Data sinks** area list.

## Pipeline configuration

When it comes to using this Data sink in a [Pipeline](https://docs.onum.com/the-workspace/pipelines), you must configure the following output parameters. To do it, simply click the Data sink on the canvas and select **Configuration**.

### Output configuration

<table><thead><tr><th width="169.7578125">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Event field</strong><mark style="color:red;">*</mark></td><td>Select the incoming field containing the message to send on.</td></tr><tr><td><strong>Slack channels</strong><mark style="color:red;">*</mark></td><td>Choose the input fields that contain the Slack channels you want to send the message to.</td></tr></tbody></table>

Click **Save** to save your configuration.