# Event Subscriptions Your app can subscribe to and handle Slack events based on the [Events API](https://api.slack.com/events?filter=Events). The `app_uninstalled` and `tokens_revoked` events are required if you expect to disconnect your Slack app from an org and reconnect to a different org. See [Org Connections](/docs/platform/salesforce-slack-sdk/guide/orgs-multi.md). :::note `message_metadata_*` and `workflow_*` events are not supported. ::: ## Slack Events The Slack events correspond to the following Apex classes. :::tip To ensure that your app handles Slack events correctly, include the required scopes listed on the Slack event documentation in your app manifest and `MySlackAppName.slackapp-meta.xml` file. ::: | Slack Event Name | Description | Apex Class | | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [app_home_opened](https://api.slack.com/events/app_home_opened) | User clicked into your App Home | [Slack.AppHomeOpenedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#apphomeopenedevent-class) | | [app_mention](https://api.slack.com/events/app_mention) | Subscribe to only the message events that mention your app or bot | [Slack.AppMentionEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#appmentionevent-class) | | [app_rate_limited](https://api.slack.com/events/app_rate_limited) | Your app's event subscriptions are being rate limited | [Slack.AppRateLimitedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#appratelimitedevent-class) | | [app_requested](https://api.slack.com/events/app_requested) | User requested an app | [Slack.AppRequestedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#apprequestedevent-class) | | [app_uninstalled](https://api.slack.com/events/app_uninstalled) | Your Slack app was uninstalled | [Slack.AppUninstalledEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#appuninstalledevent-class) | | [call_rejected](https://api.slack.com/events/call_rejected) | A call was rejected | [Slack.CallRejectedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#callrejectedevent-class) | | [channel_archive](https://api.slack.com/events/channel_archive) | A channel was archived | [Slack.ChannelArchiveEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelarchiveevent-class) | | [channel_created](https://api.slack.com/events/channel_created) | A channel was created | [Slack.ChannelCreatedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelcreatedevent-class) | | [channel_deleted](https://api.slack.com/events/channel_deleted) | A channel was deleted | [Slack.ChannelDeletedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channeldeletedevent-class) | | [channel_history_changed](https://api.slack.com/events/channel_history_changed) | Bulk updates were made to a channel's history | [Slack.ChannelHistoryChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelhistorychangedevent.class) | | [channel_id_changed](https://api.slack.com/events/channel_id_changed) | A channel ID was changed | [Slack.ChannelIdChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelidchangedevent-class) | | [channel_left](https://api.slack.com/events/channel_left) | You left a channel | [Slack.ChannelLeftEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelleftevent-class) | | [channel_rename](https://api.slack.com/events/channel_rename) | A channel was renamed | [Slack.ChannelRenameEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelrenameevent-class) | | [channel_shared](https://api.slack.com/events/channel_shared) | A channel has been shared with an external workspace | [Slack.ChannelSharedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelsharedevent-class) | | [channel_unarchive](https://api.slack.com/events/channel_unarchive) | A channel was unarchived | [Slack.ChannelUnarchiveEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelunarchiveevent-class) | | [channel_unshared](https://api.slack.com/events/channel_unshared) | A channel has been unshared with an external workspace | [Slack.ChannelUnsharedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#channelunsharedevent-class) | | [dnd_updated](https://api.slack.com/events/dnd_updated) | Do not Disturb settings changed for the current user | [Slack.DndUpdatedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#dndupdatedevent-class) | | [dnd_updated_user](https://api.slack.com/events/dnd_updated_user) | Do not Disturb settings changed for a member | [Slack.DndUpdatedUserEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#dndupdateduserevent-class) | | [email_domain_changed](https://api.slack.com/events/email_domain_changed) | The workspace email domain has changed | [Slack.EmailDomainChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#emaildomainchangedevent-class) | | [ekm_access_denied](https://api.slack.com/events/message/ekm_access_denied) | A piece of content was redacted by an admin | [Slack.MessageEkmAccessDeniedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messageekmaccessdeniedevent-class) | | [emoji_changed](https://api.slack.com/events/emoji_changed) | A custom emoji has been added or changed | [Slack.EmojiChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#emojichangedevent-class) | | [file_change](https://api.slack.com/events/file_change) | A file was changed | [Slack.FileChangeEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#filechangeevent-class) | | [file_created](https://api.slack.com/events/file_created) | A file was created | [Slack.FileCreatedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#filecreatedevent-class) | | [file_deleted](https://api.slack.com/events/file_deleted) | A file was deleted | [Slack.FileDeletedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#filedeletedevent-class) | | [file_public](https://api.slack.com/events/file_change) | A file was made public | [Slack.FilePublicEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#filepublicevent-class) | | [file_shared](https://api.slack.com/events/file_shared) | A file was shared | [Slack.FileSharedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#filesharedevent-class) | | [file_unshared](https://api.slack.com/events/file_change) | A file was unshared | [Slack.FileUnsharedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#fileunsharedevent-class) | | [grid_migration_finished](https://api.slack.com/events/grid_migration_finished) | An enterprise grid migration has finished on this workspace. | [Slack.GridMigrationFinishedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#gridmigrationfinishedevent-class) | | [grid_migration_started](https://api.slack.com/events/grid_migration_started) | An enterprise grid migration has started on this workspace. | [Slack.GridMigrationStartedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#gridmigrationstartedevent-class) | | [group_archive](https://api.slack.com/events/group_archive) | A private channel was archived | [Slack.GroupArchiveEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#grouparchiveevent-class) | | [group_close](https://api.slack.com/events/group_close) | You closed a private channel | [Slack.GroupCloseEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#groupcloseevent-class) | | [group_deleted](https://api.slack.com/events/group_deleted) | A private channel was deleted | [Slack.GroupDeletedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#groupdeletedevent-class) | | [group_history_changed](https://api.slack.com/events/group_history_changed) | Bulk updates were made to a private channel's history | [Slack.GroupHistoryChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#grouphistorychangedevent-class) | | [group_left](https://api.slack.com/events/group_left) | You left a private channel | [Slack.GroupLeftEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#groupleftevent-class) | | [group_open](https://api.slack.com/events/group_open) | You created a group DM | [Slack.GroupOpenEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#groupopenevent-class) | | [group_rename](https://api.slack.com/events/group_rename) | A private channel was renamed | [Slack.GroupRenameEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#grouprenameevent-class) | | [group_unarchive](https://api.slack.com/events/group_unarchive) | A private channel was unarchived | [Slack.GroupUnarchiveEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#groupunarchiveevent-class) | | [im_close](https://api.slack.com/events/im_close) | You closed a DM | [Slack.ImCloseEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#imcloseevent-class) | | [im_created](https://api.slack.com/events/im_created) | A DM was created | [Slack.ImCreatedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#imcreatedevent-class) | | [im_history_changed](https://api.slack.com/events/im_history_changed) | Bulk updates were made to a DM's history | [Slack.ImHistoryChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#imhistorychangedevent-class) | | [im_open](https://api.slack.com/events/im_open) | You opened a DM | [Slack.ImOpenEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#imopenevent-class) | | [invite_requested](https://api.slack.com/events/invite_requested) | User requested an invite | [Slack.InviteRequestedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#inviterequestedevent-class) | | [link_shared](https://api.slack.com/events/link_shared) | A message was posted containing one or more links relevant to your application | [Slack.LinkSharedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#linksharedevent-class) | | [member_joined_channel](https://api.slack.com/events/member_joined_channel) | A user joined a public or private channel | [Slack.MemberJoinedChannelEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#memberjoinedchannelevent-class) | | [member_left_channel](https://api.slack.com/events/member_left_channel) | A user left a public or private channel | [Slack.MemberLeftChannelEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#memberleftchannelevent-class) | | [message](https://api.slack.com/events/message) | A message was sent to a channel | [Slack.MessageEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messageevent-class), [Slack.MessageBotEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagebotevent-class), [Slack.MessageChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagechangedevent-class), [Slack.MessageChannelJoinEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagechanneljoinevent-class), [Slack.MessageChannelPostingPermissionsEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagechannelpostingpermissionsevent-class), [Slack.MessageChannelTopicEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagechanneltopicevent-class), [Slack.MessageDeletedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagedeletedevent-class), [Slack.MessageFileShareEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagefileshareevent-class), [Slack.MessageGroupTopicEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagegrouptopicevent-class), [Slack.MessageMeEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagemeevent-class), [Slack.MessageRepliedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagerepliedevent-class), [Slack.MessageThreadBroadcastEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messagethreadbroadcastevent-class) | | [message.channels](https://api.slack.com/events/message.channels) | A message was posted to a channel | [Slack.MessageEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messageevent-class) | | [message.groups](https://api.slack.com/events/message.groups) | A message was posted to a private channel | [Slack.MessageEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messageevent-class) | | [message.im](https://api.slack.com/events/message.im) | A message was posted in a direct message channel | [Slack.MessageEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messageevent-class) | | [message.mpim](https://api.slack.com/events/message.mpim) | A message was posted in a multiparty direct message channel | [Slack.MessageEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#messageevent-class) | | [pin_added](https://api.slack.com/events/pin_added) | A pin was added to a channel | [Slack.PinAddedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#pinaddedevent-class) | | [pin_removed](https://api.slack.com/events/pin_removed) | A pin was removed from a channel | [Slack.PinRemovedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#pinremovedevent-class) | | [reaction_added](https://api.slack.com/events/reaction_added) | A member added an emoji reaction to an item | [Slack.ReactionAddedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#reactionaddedevent-class) | | [reaction_removed](https://api.slack.com/events/reaction_removed) | A member removed an emoji reaction | [Slack.ReactionRemovedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#reactionremovedevent-class) | | [scope_denied](https://api.slack.com/events/scope_denied) | [Deprecated](#deprecated-events). OAuth scopes were denied to your app | [Slack.ScopeDeniedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#scopedeniedevent-class) | | [scope_granted](https://api.slack.com/events/scope_granted) | [Deprecated](#deprecated-events). OAuth scopes were granted to your app | [Slack.ScopeGrantedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#scopegrantedevent-class) | | [star_added](https://api.slack.com/events/star_added) | A member has starred an item | [Slack.StarAddedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#staraddedevent-class) | | [star_removed](https://api.slack.com/events/star_removed) | A member removed a star | [Slack.StarRemovedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#starremovedevent-class) | | [subteam_created](https://api.slack.com/events/subteam_created) | A User Group has been added to the workspace | [Slack.SubteamCreatedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#subteamcreatedevent-class) | | [subteam_members_changed](https://api.slack.com/events/subteam_members_changed) | The membership of an existing User Group has changed | [Slack.SubteamMembersChangedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#subteammemberschangedevent-class) | | [subteam_self_added](https://api.slack.com/events/subteam_self_added) | You have been added to a User Group | [Slack.SubteamSelfAddedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#subteamselfaddedevent-class) | | [subteam_self_removed](https://api.slack.com/events/subteam_self_removed) | You have been removed from a User Group | [Slack.SubteamSelfRemovedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#subteamselfremovedevent-class) | | [subteam_updated](https://api.slack.com/events/subteam_updated) | An existing User Group has been updated or its members changed | [Slack.SubteamUpdatedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#subteamupdatedevent-class) | | [team_access_granted](https://api.slack.com/events/team_access_granted) | Access to a set of teams was granted to your app | [Slack.TeamAccessGrantedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#teamaccessgrantedevent-class) | | [team_access_revoked](https://api.slack.com/events/team_access_revoked) | Access to a set of teams was revoked from your app | [Slack.TeamAccessRevokedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#teamaccessrevokedevent-class) | | [team_domain_change](https://api.slack.com/events/team_domain_change) | The workspace domain has changed | [Slack.TeamDomainChangeEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#teamdomainchangedevent-class) | | [team_join](https://api.slack.com/events/team_join) | A new member has joined | [Slack.TeamJoinEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#teamjoinevent-class) | | [team_rename](https://api.slack.com/events/team_rename) | The workspace name has changed | [Slack.TeamRenameEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#teamrenameevent-class) | | [tokens_revoked](https://api.slack.com/events/tokens_revoked) | API tokens for your app were revoked | [Slack.TokensRevokedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#tokensrevokedevent-class) | | [user_change](https://api.slack.com/events/user_change) | A member's data has changed | [Slack.UserChangeEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#userchangedevent-class) | | [user_resource_denied](https://api.slack.com/events/user_resource_denied) | User resource was denied to your app | [Slack.UserResourceDeniedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#userresourcedeniedevent-class) | | [user_resource_granted](https://api.slack.com/events/user_resource_granted) | User resource was granted to your app | [Slack.UserResourceGrantedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#userresourcegrantedevent-class) | | [user_resource_removed](https://api.slack.com/events/user_resource_removed) | User resource was removed from your app | [Slack.UserResourceRemovedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#userresourceremovedevent-class) | ## Synthetic Events Synthetic events are specific to the Apex SDK and don't have a Slack equivalent. The following synthetic event is available. | Event Name | Description | | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | | [UisfUserAuthedEvent](/docs/platform/salesforce-slack-sdk/guide/apex_ref_events.md#uisfuserauthedevent-class) | A user successfully authenticated and connected the app to a Salesforce org | :::important Persisting app home views based on a user's authentication status is currently not supported. ::: ## Deprecated Events Slack [retired legacy workspace apps](https://api.slack.com/changelog/2021-03-workspace-apps-to-retire-in-august-2021#events), which also deprecated the following events. - resources_added - resources_removed - scope_denied - scope_granted scope_denied and scope_granted map to corresponding Apex classes (Slack.ScopeDeniedEvent and Slack.ScopeGrantedEvent) but these Apex classes are no longer supported.