> ## Documentation Index
> Fetch the complete documentation index at: https://taskflow-8047ebcf.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Get TaskFlow notifications in your Slack workspace

Connect TaskFlow to Slack and your team gets notified in a Slack channel every time a task is marked done — no manual updates required.

## What the integration does

When a task's status changes to **Done**, TaskFlow automatically posts a message to your connected Slack channel:

> ✅ **Task Completed:** Someone just finished the task "Design login page"!

<Note>
  Notifications are sent only when a task moves **into** Done status. Tasks that are already Done when the integration is connected will not trigger a notification.
</Note>

## Permissions required

Only workspace **Owners** and **Admins** can connect or disconnect the Slack integration.

## Connect Slack

<Steps>
  <Step title="Open workspace Settings">
    In TaskFlow, navigate to your workspace and open **Settings**.
  </Step>

  <Step title="Find the Integrations section">
    Scroll to the **Integrations** section on the Settings page.
  </Step>

  <Step title="Click Connect Slack">
    Click the **Connect Slack** button. You will be redirected to Slack's authorization page.
  </Step>

  <Step title="Authorize TaskFlow in Slack">
    Review the permissions TaskFlow is requesting and click **Allow**. TaskFlow requests the following scopes from Slack:

    * `chat:write` — post messages as TaskFlow
    * `chat:write.public` — post in public channels without being a member
    * `incoming-webhook` — send messages to a specific channel
  </Step>

  <Step title="Choose a channel">
    During authorization, Slack will ask which channel TaskFlow should post to. Select the channel your team wants to receive task completion notifications in.
  </Step>

  <Step title="Return to TaskFlow">
    After approving, Slack redirects you back to TaskFlow. A confirmation message confirms the connection was successful.
  </Step>
</Steps>

<Warning>
  Connecting a new Slack account replaces the existing connection. Your previous Slack channel will stop receiving notifications immediately.
</Warning>

## What happens after connecting

Once connected, TaskFlow links your workspace to the Slack channel you selected. From this point on, every time any task in the workspace is moved to Done, TaskFlow posts a completion notification to that channel automatically.

## Disconnect Slack

<AccordionGroup>
  <Accordion title="How to disconnect">
    Go to **Settings → Integrations** and click **Disconnect Slack**. TaskFlow removes the stored access token and channel. Notifications stop immediately.

    Only workspace **Owners** and **Admins** can disconnect the integration.
  </Accordion>
</AccordionGroup>