---
title: Slack
description: "## What is Slack? Slack is a messaging app for business that includes chat and collaboration tools. ## Why Should You Use the Slack Connector? The Slack connector provides visibility into the assets in your environment. You can use this…"
url: "https://lucidum.io/docs/slack/"
updated: "2024-06-29"
category: Connectors / List of Connectors / S
---

# Slack

## What is Slack?

Slack is a messaging app for business that includes chat and collaboration tools.

## Why Should You Use the Slack Connector?

The Slack connector provides visibility into the assets in your environment. You can use this visibility to:

- ensure assets are managed per your security policies
- derive relationships between assets, users, applications, and data

## How Does This Connector Work?

Lucidum executes read-only requests to the Slack REST API and ingests only meta-data about Slack devices. Lucidum does not retrieve any data stored on your assets.

## Configuring the Connector in Lucidum

| **Field** | **Description** | **Example** |
| --- | --- | --- |
| URL | The base URL for the slack service. | https://slack.com |
| API token | An API token for a new Slack app with read access to API data. | ************ |

## Source Documentation

### Creating an API Token

Before configuring the Slack connector in Lucidum, you must first create a slack app and an API token for the app. Lucidum will use the API token to access the Slack API.

***If you are using the Slack Enterprise Grid Organization solution***:

1. Go to [https://api.slack.com/apps](https://api.slack.com/apps) and create a new application.
2. From the left pane, select **OAuth & Permissions**.
3. In the **OAuth & Permissions **page, scroll down to the **Scopes** pane.
4. In the **Scopes **pane, go to ***Token Scopes*** and add the following:

   - admin.teams:read
   - admin.user:read
   - user:read
   - users:read.email
5. Generate an authentication token. Steps are described [here](https://api.slack.com/methods/admin.users.list#markdown) (after the Arguments section)

***If you are NOT using the Slack Enterprise Grid Organization solution***:

1. Go to [https://api.slack.com/apps](https://api.slack.com/apps) and create a new application.
2. From the left pane, select **OAuth & Permissions**.
3. In the **OAuth & Permissions **page, scroll down to the **Scopes** pane.
4. In the **Scopes **pane, go to ***User Token Scopes*** and add the following:

   - user:read
   - users:read.email
5. Scroll back up to the **OAuth Tokens for Your Workspace** pane. Click **Install to Workspace**.
6. When prompted, click **Allow**.
7. In the **OAuth Tokens for Your Workspace **pane, you will find the ***User OAuth Token***. Copy this. The Lucidum connector will use this Token to communicate with Slack.

### Required Permissions

Contact your Lucidum Sales Representative for help with permissions.

***If you are using Slack Enterprise Grid Organization***:

| **Object** | **Permissions** |
| --- | --- |
|  User Token Scope > OAuth Scope | admin.teams:read |
|  User Token Scope > OAuth Scope | admin.users:read |
|  User Token Scope > OAuth Scope | users:read |
|  User Token Scope > OAuth Scope | users.read:email |

***If you are NOT using Slack Enterprise Grid Organization***:

| **Object** | **Permissions** |
| --- | --- |
|  User Token Scope > OAuth Scope | users:read |
|  User Token Scope > OAuth Scope | users.read:email |

### API Documentation

[https://api.slack.com/apis](https://api.slack.com/apis)