Slack List Conversations

Controlled node

Overview

Retrieves a list of Slack conversations (channels, direct messages, and group messages) accessible to the connected Slack workspace. This node supports pagination to handle large numbers of conversations, allowing you to retrieve up to 1,000 conversations per workflow run.

The node queries the Slack API for conversation types including public channels, private channels, instant messages (IM), and multi-party instant messages (MPIM).

Pagination

Slack API limits results to 200 conversations per request. This node automatically handles pagination up to 5 pages (1,000 total conversations). To retrieve additional conversations beyond 1,000, use the cursor output from the result and feed it back into the cursor input for subsequent calls.

Inputs

Input	Type	Description	Default
Run	Event	Triggers the node to fetch conversations from Slack.	-
Limit	Number	The maximum number of conversations to return per page (max 200).	200
Max Pages	Number	The maximum number of pages to fetch (max 5). Each page retrieves up to limit conversations.	5
Cursor	Text	Pagination cursor from a previous call. Leave empty for the first request; provide the cursor from previous results to fetch the next set of conversations.	-
Connections	Connection	The Slack workspace connection to use. Must be configured in the project connections.	-

Outputs

Output	Type	Description
Done	Event	Fires when the node has finished fetching conversations.
Conversations	Data	An array of conversation objects containing channel IDs, names, types, and metadata. Returns an error object if the request fails.

Runtime Behavior and Defaults

When triggered, the node validates that:

• A valid Slack connection is selected
• The limit does not exceed 200 (enforced maximum)
• The maxPages does not exceed 5 (enforced maximum)

If validation passes, the node calls the Slack API to fetch conversations of types: public_channel, private_channel, im, and mpim. It automatically paginates through up to maxPages pages, combining results into a single output array.

The node returns up to 1,000 conversations total (200 limit × 5 pages). If more conversations exist, the last page's result will include a next_cursor in the response metadata, which can be extracted and passed to the cursor input of a subsequent node call to continue pagination.

Example Usage

Basic Conversation Listing

Connect a Start node to the Run input of Slack List Conversations. Set the Limit to 100 and Max Pages to 2 to retrieve up to 200 recent conversations. Connect the Conversations output to a processing node to iterate through the results.

Paginated Retrieval

To retrieve more than 1,000 conversations or implement pagination:

1. First call: Leave Cursor empty, set Max Pages to 5
2. Extract the next_cursor from the Conversations output (typically found in response_metadata.next_cursor)
3. Feed this cursor value into the Cursor input of a subsequent Slack List Conversations node
4. Repeat until no cursor is returned (all conversations fetched)

// Example output structure (conversations array):
[
  {
    "id": "C1234567890",
    "name": "general",
    "is_channel": true,
    "is_private": false,
    "created": 1360782804,
    "creator": "U1234567890"
  },
  // ... more conversations
]