Go to Slack

subteam_updated event

Compatibility: RTM Events API

Events API Scope: usergroups:read

An existing User Group has been updated or its members changed

    "type": "subteam_updated",
    "subteam": {
       "id": "S0614TZR7",
       "team_id": "T060RNRCH",
       "is_usergroup": true,
       "name": "Team Admins",
       "description": "A group of all Administrators on your team.",
       "handle": "admins",
       "is_external": false,
       "date_create": 1446598059,
       "date_update": 1446670362,
       "date_delete": 0,
       "auto_type": "admin",
       "created_by": "USLACKBOT",
       "updated_by": "U060RNRCZ",
       "deleted_by": null,
       "prefs": {
           "channels": [

           "groups": [

       "users": [
       "user_count": "4"

The subteam_updated event is sent to all connections for a team when an existing User Group is updated. This event is triggered for changes to the User Group information (name, description, or handle) as well as the members of the group. Clients can use this to update their local list of groups and group members. The users field is truncated at 500, however the user_count field will still show the actual count.

This event type may also arise when a subteam has been disabled.

Events API compatibility

Subscribe to this event via the Events API.

Events of this type will be wrapped in metadata when sent via the Events API.

subteam_updated requires the usergroups:read OAuth permission scope.