# Slack OAuth Integration

The Slack OAuth Integration in StepSecurity enables you to receive real-time security notifications directly in your Slack workspace. This method provides a more reliable delivery mechanism and better channel management than webhook-based notifications. The Slack OAuth integration does not require you to manage or store credentials.

### How to Set Up the Slack OAuth App Integration

#### Step 1: Navigate to the Slack App Integration

* Go to Admin Console → Integrations → Slack App Integration.
* If you have not installed the Slack app before, you will see setup instructions along with an Install Slack App button. Click Install Slack App to begin.

<figure><img src="/files/vFZpmHjdabKTdSFkljdo" alt=""><figcaption></figcaption></figure>

#### Step 2: Review and Approve Permissions

Review the requested Slack app permissions, then click Allow to authorize the integration.

<figure><img src="/files/2s0SFQGsm9ruUjjOivtg" alt=""><figcaption></figcaption></figure>

#### Step 3: Configure Notification Channels

* Follow the on-screen instructions to configure Slack channels and specify a default Slack channel ID where notifications will be sent. To customize t he types of notification events you want to receive, [see this section](/administration/settings/notifications.md#configuring-notifications).

<figure><img src="/files/D7SczUrlQRNRFQ6p01Jw" alt=""><figcaption></figcaption></figure>

* Create a new Slack channel or use an existing one.
* In the channel message box, type `/invite @StepSecurity` . You will receive a notification confirming that StepSecurity has joined the channel.

<figure><img src="/files/2ZaZBt03ELtKsTHXjr38" alt=""><figcaption></figcaption></figure>

* Open the channel About section and copy the Channel ID shown at the bottom.

<figure><img src="/files/NcqUGzOf3OBYG5BBZl2o" alt=""><figcaption></figcaption></figure>

* Paste the Channel ID into the Default Slack Channel field.
* Click Test Connection. A successful setup will display a confirmation message, indicating that the Slack integration is working correctly.

<figure><img src="/files/IN9jf9PPjJC1nIYfzy9R" alt=""><figcaption></figcaption></figure>

#### Step 4: Configure Organization-Specific Settings

Optionally, configure organization-specific settings by selecting which Slack channels should receive notifications for each organization.

<figure><img src="/files/FBkKwrGZyZvfehmAo8mX" alt=""><figcaption></figcaption></figure>

**Follow this interactive demo to see how to setup Slack OAuth App:**

{% embed url="<https://app.storylane.io/share/b4af7m1ykzlv>" %}


---

# 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.stepsecurity.io/administration/admin-console/integrations/slack-oauth-integration.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.