> For the complete documentation index, see [llms.txt](https://help.radiantsecurity.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.radiantsecurity.ai/radiant-connectors/communication-tools/slack.md).
# Slack
In this guide, you will create an API token in Slack to pull Slack user IDs and send messages to users. These messages will allow users to respond to suspicious login alerts to understand if they have been impacted.
At the end of this configuration, you will provide Radiant Security with these values:
* **Access Token** (Bot User OAuth Token) (for example `xoxb-123123123321-529...`)
### Generate the Bot User OAuth Token
1. Sign into [Slack](https://slack.com/oauth/v2/authorize?client_id=2179644537937.5282173714550\&scope=chat:write,im:read,im:write,users:read,users:read.email,chat:write.customize\&user_scope=).
2. If your Slack Workspace requires admin approval for adding apps, then you will submit a request for installation to Slack. If not, then skip to step 3.\
3. After your request to install has been approved, you will receive a Slack notification that will allow you to continue the installation.
3. Click **Allow** to allow Radiant Security access to the workspace. If you are a part of multiple workspaces, you will be asked to select and log into the one you choose.
4. You will be redirected to a page that contains the Bot User OAuth Token required for the configuration of the Radiant Security Slack connector. Ensure that you save the **Bot User OAuth Token** as you will need it for the upcoming step.
### Add the credentials in Radiant Security
1. Log in to [Radiant Security](https://app.radiantsecurity.ai/).
2. From the navigation menu, select **Settings** > **Credentials** and click **+ Add Credential**.
3. Select the **Slack** vendor from the list and click **Configure Credential.**
4. Under **Credential Name**, give the credential an identifiable name (e.g. `Slack Credentials`).
5. Under **Required** **Credentials**, add the **Bot User OAuth Token** that you copied from the previous step.
6. Click **Add Credential** to save the changes.
### Review app management settings
In Slack's **App Management Settings**, toggle **Off** the **Only allow apps from the Slack App Directory** setting**.** This will add The Radiant app to the workspace.
### Approve for this workspace
Once the app is installed, now it also will require to be approved to be added to the Slack workspace. Go to **Slack Admin Page > Configure Apps**, and select **Approve for this workspace**.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://help.radiantsecurity.ai/radiant-connectors/communication-tools/slack.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.