List available Slack conversations

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.

GET /integrations/slack/list

JavaScript

JavaScript

import Hyperspell from '@hyperspell/hyperspell';

const client = new Hyperspell({
  apiKey: process.env['HYPERSPELL_API_KEY'], // This is the default and can be omitted
});

const slacks = await client.integrations.slack.list();

console.log(slacks);

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

APIKeyAsUser

Authorization · string · header · required

API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.

Query Parameters

channels · string[]

List of Slack channels to include (by id, name, or #name).

include_private · boolean · default: false

Include private channels when constructing Slack 'types'.

include_dms · boolean · default: false

Include direct messages (im) when listing conversations.

include_group_dms · boolean · default: false

Include group DMs (mpim) when listing conversations.

exclude_archived · boolean | null

If set, pass 'exclude_archived' to Slack. If None, omit the param.

Response

200

application/json

Successful Response