# Send data to Slack

{% hint style="info" %}
See the changelog of the **Slack** Data sink type [here](/data-sinks/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**](/the-workspace/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](/administration/global-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](/administration/global-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](/administration/global-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](/administration/global-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](/administration/global-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.


---

# Agent Instructions: 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:

```
GET https://docs.onum.com/the-workspace/data-sinks/data-sink-integrations/send-data-to-slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.