Go to Slack

Event Types for the Events API

Developer preview

This feature only applies to the workspace token-based Slack app developer preview, currently under active development.


These events undergo the formality of actually occurring in the Events API. Manage your Slack app to subscribe to the events you want to process.

Event Description Required Scope
app_uninstalled

Your Slack app was uninstalled.

None
channel_archive

A channel was archived

channels:read
channel_created

A channel was created

channels:read
channel_deleted

A channel was deleted

channels:read
channel_history_changed

Bulk updates were made to a channel's history

channels:history
channel_rename

A channel was renamed

channels:read
channel_unarchive

A channel was unarchived

channels:read
dnd_updated

Do not Disturb settings changed for the current user

dnd:read
dnd_updated_user

Do not Disturb settings changed for a member

dnd:read
email_domain_changed

The workspace email domain has changed

team:read
emoji_changed

A custom emoji has been added or changed

emoji:read
file_change

A file was changed

files:read
file_comment_added

A file comment was added

files:read
file_comment_deleted

A file comment was deleted

files:read
file_comment_edited

A file comment was edited

files:read
file_created

A file was created

files:read
file_deleted

A file was deleted

files:read
file_public

A file was made public

files:read
file_shared

A file was shared

files:read
file_unshared

A file was unshared

files:read
grid_migration_finished

An enterprise grid migration has finished on this workspace.

None
grid_migration_started

An enterprise grid migration has started on this workspace.

None
group_archive

A private channel was archived

groups:read
group_close

You closed a private channel

groups:read
group_history_changed

Bulk updates were made to a private channel's history

groups:history
group_open

You opened a private channel

groups:read
group_rename

A private channel was renamed

groups:read
group_unarchive

A private channel was unarchived

groups:read
im_close

You closed a DM

im:read
im_created

A DM was created

im:read
im_history_changed

Bulk updates were made to a DM's history

im:history
im_open

You opened a DM

im:read
link_shared

A message was posted containing one or more links relevant to your application

links:read
member_joined_channel

A user joined a public or private channel

channels:read
member_left_channel

A user left a public or private channel

channels:read
message

A message was sent to a channel

channels:history
message.channels

A message was posted to a channel

channels:history
message.groups

A message was posted to a private channel

groups:history
message.im

A message was posted in a direct message channel

im:history
message.mpim

A message was posted in a multiparty direct message channel

mpim:history
pin_added

A pin was added to a channel

pins:read
pin_removed

A pin was removed from a channel

pins:read
reaction_added

A member has added an emoji reaction to an item

reactions:read
reaction_removed

A member removed an emoji reaction

reactions:read
resources_added

Access to a set of resources was granted for your app

None
resources_removed

Access to a set of resources was removed for your app

None
scope_denied

OAuth scopes were denied to your app

None
scope_granted

OAuth scopes were granted to your app

None
star_added

A member has starred an item

stars:read
star_removed

A member removed a star

stars:read
subteam_created

A User Group has been added to the workspace

usergroups:read
subteam_members_changed

The membership of an existing User Group has changed

usergroups:read
subteam_self_added

You have been added to a User Group

usergroups:read
subteam_self_removed

You have been removed from a User Group

usergroups:read
subteam_updated

An existing User Group has been updated or its members changed

usergroups:read
team_domain_change

The workspace domain has changed

team:read
team_join

A new member has joined

users:read
team_rename

The workspace name has changed

team:read
tokens_revoked

API tokens for your app were revoked.

None
url_verification

Verifies ownership of an Events API Request URL

None
user_change

A member's data has changed

users:read