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

# Slack

> Connect Slack with a bot token or incoming webhook so Nota can post to your workspace.

# 💬 Slack (team feature)

Use a Slack bot token or an incoming webhook to let Nota post updates or alerts into your workspace. On the Integrations page, open the Slack card—**Configure** to add it, **Update** to rotate it.

<img src="https://mintcdn.com/notaai/1x5ZOEq8LGaWrXEp/images/integrations-slack.png?fit=max&auto=format&n=1x5ZOEq8LGaWrXEp&q=85&s=f145db058a2984d6ce5047c2d745628c" alt="Placeholder: Slack bot token screen" width="1" height="1" data-path="images/integrations-slack.png" />

## What you need

* **Slack Bot Token** (starts with `xoxb-`)
* Permission to create or manage Slack apps in your workspace
* Access to **Integrations → Slack** in the left nav

## Create a Slack bot token

1. Visit [api.slack.com/apps](https://api.slack.com/apps) and click **Create New App → From scratch**.
2. Name the app (e.g., “Nota Bot”) and pick the workspace.
3. In **OAuth & Permissions**, under **Bot Token Scopes**, add at least:
   * `chat:write` (post messages as the bot)
   * `chat:write.public` if you need to post in channels the bot isn’t invited to yet
   * `files:write` if you plan to upload attachments
4. Click **Install to Workspace** and approve the permissions.
5. Copy the **Bot User OAuth Token** (starts with `xoxb-`). Store it securely.

## Add the token in Nota

1. Open **Integrations** in the left nav and select the **Slack** card.
2. Paste the **Bot User OAuth Token** (`xoxb-...`) into the token field.
3. Save. Nota will use this token immediately—no environment variable or redeploy needed.

> ✅ Keep the bot in only the channels it needs. If permissions change, reinstall to refresh the token.

## Getting started with incoming webhooks

Incoming webhooks are the fastest way to post messages into a single channel. Use this if you do not need bot-level features like uploading files.

### Create a webhook URL

1. Visit [api.slack.com/apps](https://api.slack.com/apps) and click **Create New App → From scratch**.
2. Name the app (e.g., "Nota Webhook") and pick the workspace.
3. Open **Incoming Webhooks** and toggle **Activate Incoming Webhooks** on.
4. Click **Add New Webhook to Workspace**, choose a channel, and approve.
5. Copy the **Webhook URL** (starts with `https://hooks.slack.com/services/`).

### Add the webhook in Nota

1. Open **Integrations** in the left nav and select the **Slack** card.
2. Paste the **Webhook URL** into the incoming webhook field.
3. Save. Nota will start posting to the selected channel.

> ✅ Webhooks are channel-specific. Create a new webhook URL for the channel you want to target.