---
title: "List available Slack conversations"
method: GET
path: "/integrations/slack/list"
tags: ["Integrations", "Integrations"]
---

# List available Slack conversations

`GET /integrations/slack/list`

List Slack conversations accessible to the user via the live Nango connection.

Returns minimal channel metadata suitable for selection UIs. If required
scopes are missing, Slack's error is propagated with details.

Supports filtering by channels, including/excluding private channels, DMs,
group DMs, and archived channels based on the provided search options.

## Query parameters

- `channels` string[] — List of Slack channels to include (by id, name, or #name).
- `include_private` boolean — Include private channels when constructing Slack 'types'.
- `include_dms` boolean — Include direct messages (im) when listing conversations.
- `include_group_dms` boolean — Include group DMs (mpim) when listing conversations.
- `exclude_archived` boolean, nullable — If set, pass 'exclude_archived' to Slack. If None, omit the param.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hyperspell/apis/hyperspell-api.md) · [All operations](https://skmtc.net/hyperspell/apis/hyperspell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperspell/hyperspell-api/revisions/5721acd588e6/schema)