View all event types

user_change

A member's data has changed

Facts

Required scopes

users:read

Works with

RTMEvents API

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. Custom fields being modified on a user profile will not trigger the user_change event.

The user_change event will not be dispatched if tz_offset changes due to daylight savings. Any other tz_offset changes will result in an event being dispatched.

Depending on what event took place, one of the following three other events will be dispatched simultaneously:

Use 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.

Example payload 

{
    "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