Users

Users List

GET
/users.list

Lists all users in a Slack team.

Authorization

slackAuth users:read
AuthorizationBearer <token>

In: header

Scope: users:read

Query Parameters

token?string

Authentication token. Requires scope: users:read

limit?integer

The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached. Providing no limit value will result in Slack attempting to deliver you the entire result set. If the collection is too large you may experience limit_required or HTTP 500 errors.

Formatint32
cursor?string

Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection.

include_locale?boolean

Set this to true to receive the locale for users. Defaults to false

Header Parameters

Content-Type*"application/x-www-form-urlencoded"

Value in

  • "application/x-www-form-urlencoded"

Response Body

application/json

application/json

curl -X GET "https://example.com/users.list" \  -H "Content-Type: application/x-www-form-urlencoded"
{  "cache_ts": 0,  "members": [    null  ],  "ok": "True",  "response_metadata": null}