---
title: "List Slack integrations"
method: GET
path: "/integration/slack/list"
tags: ["Slack Integration"]
---

# List Slack integrations

`GET /integration/slack/list`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/integration/slack/list`
- Auth: HTTP bearer

## Query parameters

- `cursor` string: The cursor to use for pagination
- `order` 'asc' | 'desc': The order of the paginated items
- `take` integer: The number of items to retrieve
- `meta` object: Key-value pairs to filter the items by metadata

## Response `200`

The list of Slack integrations was retrieved successfully

- object
  - `items` object[], required
    - `alias` string, nullable: The unique alias for the instance
    - `name` string: The associated name
    - `description` string: The associated description
    - `meta` Meta: Meta data information
    - `id` string, required: The instance ID
    - `createdAt` number, required: The timestamp (ms) when the instance was created
    - `updatedAt` number, required: The timestamp (ms) when the instance was updated
    - `botId` string, nullable: The ID of the bot this configuration is using
    - `blueprintId` string, nullable: The ID of the blueprint
    - `signingSecret` string: The signing secret (returned as '********' if configured, null otherwise)
    - `botToken` string: The bot token (returned as '********' if configured, null otherwise)
    - `userToken` string: The user token (returned as '********' if configured, null otherwise)
    - `contactCollection` boolean: Weather to collect contacts
    - `sessionDuration` number: The session duration for the Slack integration
    - `references` boolean: Whether to enable references feature
    - `ratings` boolean: Whether to enable ratings buttons feature
    - `visibleMessages` number: The number of visible messages outside of the new thread
    - `autoRespond` string: Configure automatic response behavior. Use '@all' to respond to all messages, '@agent <instructions>' for agent-powered decisions, or custom instructions for lightweight LLM filtering. Null/empty defaults to current behavior (DMs, mentions, threads only).
    - `allowFrom` string: Restrict which Slack users or channels can interact with this integration. Accepts Slack user IDs (U…/W…), channel IDs (C…/G…/D…), @username, or
  - `cursor` string, required: Cursor for fetching the next page

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)