users.info method
We're still building and not all features are available quite yet. Enjoy this peek into the future!
Not ready for the future? Return to the past at api.slack.com.
Usage info
This method returns information about a member of a workspace.
Response
Returns a user object.
Profile
The profile hash contains as much information as the user has supplied in the default profile fields: first_name, last_name, real_name, display_name, skype, and the image_* fields. Only the image_* fields are guaranteed to be included. Data that has not been supplied may not be present at all, may be null or may contain the empty string ("").
The composition of user objects can vary greatly depending on the API being used, or the context of each Slack workspace. One example where the profile information varies is getting data for a user connected through Slack Connect; an example of that type of user object can be found in the External members section of the Slack Connect page.
A user's custom profile fields may be discovered using users.profile.get.
Email addresses
The [users:read.email](/reference/scopes/users.read.email OAuth scope is now required to access the email field in user objects returned by the users.list and users.info web API methods. users:read is no longer a sufficient scope for this data field. Learn more.
Apps created after January 4th, 2017 must request both the users:read and users:read.email OAuth permission scopes simultaneously when using the OAuth app installation flow to enable access to the email field of user objects returned by this method.
Presence
A user's presence is found using users.getPresence.
Shared channels
When looking up a user belonging to a foreign workspace party to a shared channel, you'll find an is_stranger boolean attribute.