User Operations
resource: user — 5 operations for looking up and updating workspace members
Underlying API: Slack's
users.* Web API methods.
get
Looks up a user via users.info. Requires userId.
getMany
Lists workspace members via users.list.
| Field | Required | Default | Notes |
|---|---|---|---|
returnAll | No | true | Paginate through all result pages. |
limit | No | 200 | Results per page. |
teamId | No | — | Enterprise Grid team filter. |
getProfile
Retrieves detailed profile fields via users.profile.get.
| Field | Required | Notes |
|---|---|---|
userId | Yes | Target user. |
includeLabels | No | Include custom profile field labels in the response. |
getStatus
Retrieves online/away presence via users.getPresence. Requires userId.
updateProfile
Requires a user-level OAuth token (
xoxp-...) with the users.profile:write scope — bot tokens are rejected by users.profile.set. Supply the token via the userToken field (not botToken). Only non-null fields are sent to the API.
| Field | Notes |
|---|---|
userToken | User-level OAuth token, required. |
userId | Target user. |
realName | Full display name. |
displayName | Short display name. |
email | Email address. |
phone | Phone number. |
title | Job title. |
statusText | Custom status message. |
statusEmoji | Custom status emoji, e.g. :palm_tree:. |