List Users

slack.list_users

ActionChat & messagingconnection required

Calls the Slack Web API with the connection's bot token.

Page through every member of the workspace, bots and deactivated included.

Ask about Slack All Slack nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: API key
Providers: Slack
Secret shape: the Slack bot token (xoxb-…), or {"token": "xoxb-…"}
Resolved by: config.connection_id, else node.connection_id

Configuration

4 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
limit Maximum users to return on this page (1-1000).	number	No	100	1–1000	—
cursor The next_cursor from a previous page.	string	No	—	—	—
include_locale Ask Slack to include each user's locale in the response.	boolean	No	false	—	—
team_id Workspace to list. Only needed with an org-wide token.	string	No	—	—	—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "include_locale": false,
  "limit": 100
}

Output

One shape.

result

Field	Type	Example
members[].id The user id (U… or W…).	string	—
members[].name The user's Slack handle.	string	—
members[].real_name The user's display name, when they have set one.	string	—
members[].is_bot True for a bot user.	boolean	—
members[].is_admin True when the user is a workspace admin.	boolean	—
members[].deleted True when the account has been deactivated.	boolean	—
members[].tz The user's timezone, e.g. Europe/London.	string	—
count How many users this page carries.	number	—
next_cursor Cursor for the next page, or empty when done.	string	—

{
  "count": 0,
  "members": [
    {
      "deleted": false,
      "id": "",
      "is_admin": false,
      "is_bot": false,
      "name": "",
      "real_name": "",
      "tz": ""
    }
  ],
  "next_cursor": ""
}

Notes

The bot must be a member of a private channel before it can act there (Slack answers not_in_channel otherwise).
Slack rate-limits each Web API method on its own tier; a throttled call fails with the number of seconds to wait and is safe for the node's retry policy to repeat.
Deactivated accounts are returned with deleted set to true; filter them out.

Related Slack nodes

Templates that use Slack

Solutions with Slack

See List Users run in a workflow.

In a technical demo we add the Slack connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales