> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stardeck.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Slack

> Add a Slack workspace to your organization with one click, then grant it to your apps.

Connecting Slack lets your apps post into channels and react to activity. Adding a workspace is a one-click authorization—no tokens to copy.

## Add a workspace

<Steps>
  <Step title="Open Integrations">
    In your organization dashboard, go to **[Settings →
    Integrations](https://www.stardeck.ai/dashboard/settings?tab=integrations)** and expand
    **Slack**.
  </Step>

  <Step title="Add to Slack">
    Click **Add to Slack**. You'll be taken to Slack to choose a workspace and approve the
    permissions Stardeck needs.
  </Step>

  <Step title="Approve">
    Slack sends you back to Stardeck and the workspace appears in your list, ready to grant to apps.
  </Step>
</Steps>

You can add more than one workspace—each appears as its own connection.

### Enable receiving (optional)

If you want your apps to **react** to Slack activity (messages, mentions, button clicks), copy the **events URL** shown on the connection and paste it into your Slack app's **Event Subscriptions** and **Interactivity** settings. Sending messages works without this; only inbound does. See [Receiving events](/connected-services/slack/receiving-events).

## Grant the connection to your apps

A connection does nothing until you allow an app to use it.

<Steps>
  <Step title="Open Grants">On the connection, click **Grants**.</Step>

  <Step title="Add an app">
    Pick an app from your organization and grant it access. Repeat for each app that should use this
    workspace.
  </Step>

  <Step title="Set a default">
    If an app can reach more than one workspace, mark one as the **default** (the star). The agent
    uses the default when you don't name a specific workspace.
  </Step>
</Steps>

## Build features

Once a connection is granted, open the app's project chat and describe what you want:

```
Post new signups to our #growth channel in Slack
```

The agent builds against the granted connection automatically. It posts to whichever channel you name—make sure the Stardeck bot is a member of any private channel you want it to post in.

## Re-authorize

If a connection shows an **invalid** or **revoked** status, the Slack authorization has lapsed. Click **Re-authorize** and approve access again. Your grants and defaults are preserved.

## Disconnect

Click **Disconnect** on a connection to remove it. Any app relying on it can no longer post or receive through that workspace, so re-point them to another connection if needed.

## Next steps

<CardGroup cols={2}>
  <Card title="Receiving events" icon="inbox" href="/connected-services/slack/receiving-events">
    React to messages, mentions, and button clicks
  </Card>

  <Card title="What you can build" icon="sparkles" href="/connected-services/slack/overview">
    Example Slack features to ask the agent for
  </Card>
</CardGroup>