subteam_members_changed event

The membership of an existing User Group has changed

Facts

Required scopes

usergroups:read

Works with

RTMEvents API

{
    "type": "subteam_members_changed",
    "subteam_id": "S123ABC456",
    "team_id": "T060RNRCH",
    "date_previous_update": 1446670362,
    "date_update": 1492906952,
    "added_users": [
       "U060RNRCZ",
       "U060ULRC0",
       "U061309JM",
    ],
    "added_users_count": "3"
    "removed_users": [
       "U06129G2V",
    ],
    "removed_users_count": "1"
}

The subteam_members_changed event is sent to all connections for a workspace when users are added or removed from an existing User Group. Clients can use the timestamp information to detect if they are out of sync with the user list.

Unlike subteam_updated, this only shows the delta of added or removed members and does not include a snapshot of the User Group.

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