A member's data has changed
The user_change
event is sent to all connections for a workspace when a member updates their profile or data. Clients can use this to update their local cache of members.
Depending on what event took place, one of the following three other events will be dispatched simultaneously:
user_huddle_changed
, when a user's huddle status changesuser_profile_changed
, when a user's profile data changesuser_status_changed
, when a user's status changesUse the users.profile.set method to update user profile data.
Accessing email addresses
The users:read.email
OAuth scope is required to access the email field in user objects.
{
"user": {
"id": "U1234567",
"team_id": "T1234567",
"name": "some-user",
"deleted": false,
"color": "4bbe2e",
"real_name": "Some User",
"tz": "America/Los_Angeles",
"tz_label": "Pacific Daylight Time",
"tz_offset": -25200,
"profile": {
"title": "",
"phone": "",
"skype": "",
"real_name": "Some User",
"real_name_normalized": "Some User",
"display_name": "",
"display_name_normalized": "",
"fields": {},
"status_text": "riding a train",
"status_emoji": ":mountain_railway:",
"status_emoji_display_info": [],
"status_expiration": 0,
"avatar_hash": "g12345678910",
"first_name": "Some",
"last_name": "User",
"image_24": "https://secure.gravatar.com/avatar/cb0c2b2ca5e8de16be31a55a734d0f31.jpg?s=24&d=https%3A%2F%2Fdev.slack.com%2Fdev-cdn%2Fv1648136338%2Fimg%2Favatars%2Fuser_shapes%2Fava_0001-24.png",
"image_32": "https://secure.gravatar.com/avatar/cb0c2b2ca5e8de16be31a55a734d0f31.jpg?s=32&d=https%3A%2F%2Fdev.slack.com%2Fdev-cdn%2Fv1648136338%2Fimg%2Favatars%2Fuser_shapes%2Fava_0001-32.png",
"image_48": "https://secure.gravatar.com/avatar/cb0c2b2ca5e8de16be31a55a734d0f31.jpg?s=48&d=https%3A%2F%2Fdev.slack.com%2Fdev-cdn%2Fv1648136338%2Fimg%2Favatars%2Fuser_shapes%2Fava_0001-48.png",
"image_72": "https://secure.gravatar.com/avatar/cb0c2b2ca5e8de16be31a55a734d0f31.jpg?s=72&d=https%3A%2F%2Fdev.slack.com%2Fdev-cdn%2Fv1648136338%2Fimg%2Favatars%2Fuser_shapes%2Fava_0001-72.png",
"image_192": "https://secure.gravatar.com/avatar/cb0c2b2ca5e8de16be31a55a734d0f31.jpg?s=192&d=https%3A%2F%2Fdev.slack.com%2Fdev-cdn%2Fv1648136338%2Fimg%2Favatars%2Fuser_shapes%2Fava_0001-192.png",
"image_512": "https://secure.gravatar.com/avatar/cb0c2b2ca5e8de16be31a55a734d0f31.jpg?s=512&d=https%3A%2F%2Fdev.slack.com%2Fdev-cdn%2Fv1648136338%2Fimg%2Favatars%2Fuser_shapes%2Fava_0001-512.png",
"status_text_canonical": "",
"team": "T1234567"
},
"is_admin": false,
"is_owner": false,
"is_primary_owner": false,
"is_restricted": false,
"is_ultra_restricted": false,
"is_bot": false,
"is_app_user": false,
"updated": 1648596421,
"is_email_confirmed": true,
"who_can_share_contact_card": "EVERYONE",
"locale": "en-US"
},
"cache_ts": 1648596421,
"type": "user_change",
"event_ts": "1648596712.000001"
}
When an event occurs, we will send an HTTP POST request to your Request URL. The outer payload is uniform across all Events API methods, and contains fields like team_id
and event
. Learn more