Find users

Email address to search for. This is a convenience parameter that automatically performs an email-based search. Either email or search_query parameter is required.

Maximum number of users to request from Slack in this single API page before local search filtering (1 to 1000). Defaults to 50. Fewer matching users may be returned; use response_metadata.next_cursor to search subsequent pages.

Pagination cursor from response_metadata.next_cursor of a previous users.list response. Used for general searches; omit for the first page.

ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.

When true, only returns users with exact matches on name, display name, real name, first name, last name, or email fields (case-insensitive). For email queries, uses Slack's dedicated email lookup endpoint. When false, allows partial/substring matching. Defaults to false.

Include bot users in search results. Defaults to false.

Search query to find users. Can be a Slack user ID (e.g., 'U012ABCDEF'), email address, or name. For user IDs (starting with 'U' or 'W'), uses Slack's users.info API directly. For email addresses with exact_match=true, uses Slack's email lookup endpoint. For other queries, searches across name, display name, real name, email, first name, last name, and status text (case-insensitive partial matching). Either search_query (or 'query' as alias), or email parameter is required. Name-based queries can return multiple matches — verify exactly one user ID before passing to downstream tools like SLACK_OPEN_DM or SLACK_SEND_MESSAGE; disambiguate using email or real_name fields.

Include the `locale` field for each user. Defaults to `false`.

Include deleted/deactivated users in search results. Defaults to false.

Include restricted (guest) users in search results. Defaults to true.