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

# Slack integration

> Get a Slack notification in your team's feedback channel every time a user submits a survey response.

The Slack integration posts a Block Kit notification to a channel of your choice
every time a completed response lands. Once connected, it's active for **all
surveys in the project**.

<Note>
  A dedicated Integrations screen in the dashboard is on the way. Today the Slack
  connect flow is triggered via the API endpoint below; the notification
  delivery itself is fully live.
</Note>

## What you get

For each completed response, Insito posts a message containing:

* Which survey fired (name and trigger key)
* The respondent's `userId` (SDK `external_user_id`) and platform
* Each answer (NPS scores get a 🟢🟡🔴 colour cue based on the
  detractor/passive/promoter bucket)

## Connecting

Connecting uses Slack's OAuth flow. The dashboard calls:

```http theme={null}
POST /v1/dashboard/projects/:projectId/integrations/slack/connect
Authorization: Bearer <supabase-jwt>
```

The response is `{ "url": "https://slack.com/oauth/..." }`. Send the browser
there; Slack asks which channel to post to (pick or create something like
`#feedback`), and the callback at `/v1/integrations/slack/callback` persists the
token. Insito requests the `incoming-webhook` scope only — it never reads
messages or other channels.

If Slack isn't configured on the server (missing OAuth credentials), the connect
endpoint returns `503 slack_not_configured`.

## Scope

Once connected, notifications fire on every completed response in the project.
There is currently no per-survey Slack toggle.

## Disconnecting

Remove the Slack integration with:

```http theme={null}
DELETE /v1/dashboard/projects/:projectId/integrations/slack
Authorization: Bearer <supabase-jwt>
```

To fully remove Insito from your workspace, also uninstall the app from Slack's
"Manage apps" page.

## Roadmap

Planned extensions we're tracking: a dashboard connect/disconnect UI, per-survey
channel routing, and custom message templates. If you'd find these useful,
[email us](mailto:jirka@insito.app) so we can prioritise.