emoji_changed event | Slack Developer Docs reference Skip to main content Guides Reference Samples Tools Changelog Dev Program MANAGE APPS * Reference * App manifest * Block Kit * Events * Overview * accounts_changed * agent_session_stopped * agent_session_title_changed * app_context_changed * app_deleted * app_home_opened * app_installed * app_mention * app_rate_limited * app_requested * app_uninstalled_team * app_uninstalled * assistant_thread_context_changed * assistant_thread_started * bot_added * bot_changed * call_rejected * channel_archive * channel_created * channel_deleted * channel_history_changed * channel_id_changed * channel_joined * channel_left * channel_marked * channel_rename * channel_shared * channel_unarchive * channel_unshared * commands_changed * dnd_updated_user * dnd_updated * email_domain_changed * emoji_changed * entity_comments_requested * entity_details_requested * external_org_migration_finished * external_org_migration_started * file_change * file_comment_deleted * file_created * file_deleted * file_public * file_shared * file_unshared * function_executed * goodbye * grid_migration_finished * grid_migration_started * group_archive * group_close * group_deleted * group_history_changed * group_joined * group_left * group_marked * group_open * group_rename * group_unarchive * hello * im_close * im_created * im_history_changed * im_marked * im_open * invite_requested * link_shared * manual_presence_change * member_joined_channel * member_left_channel * message * message_metadata_deleted * message_metadata_posted * message_metadata_updated * message.app_home * message.channels * message.groups * message.im * message.mpim * pin_added * pin_removed * pref_change * presence_change * presence_query * presence_sub * reaction_added * reaction_removed * reconnect_url * shared_channel_invite_accepted * shared_channel_invite_approved * shared_channel_invite_declined * shared_channel_invite_received * shared_channel_invite_requested * star_added * star_removed * subteam_created * subteam_members_changed * subteam_self_added * subteam_self_removed * subteam_updated * team_access_granted * team_access_revoked * team_domain_change * team_join * team_migration_started * team_plan_change * team_pref_change * team_profile_change * team_profile_delete * team_profile_reorder * team_rename * tokens_revoked * url_verification * user_change * user_connection * user_huddle_changed * user_profile_changed * user_status_changed * user_typing * Interaction payloads * Methods * Objects * Scopes * Types * Slack Connect API * Views * * Audit Logs API * Legal Holds API * SCIM API * * Slack Status API * * Events * emoji_changed Copy as markdown On this page emoji_changed event A custom emoji has been added or changed Facts Required Scopes emoji:read Compatible APIs Events RTM Usage info ​ This example includes both the event wrapper and the event structure for the emoji_changed event. { "token" : "XXYYZZ" , "team_id" : "T123ABC456" , "api_app_id" : "A123ABC456" , "event" : { "type" : "emoji_changed" , "subtype" : "remove" , "names" : [ "picard_facepalm" ] , "event_ts" : "1361482916.000004" } , "type" : "event_callback" , "authorizations" : [ { "team_id" : "T123ABC456" , "user_id" : "U123ABC456" , "is_bot" : false , "is_enterprise_install" : false , } ] , "event_id" : "Ev123ABC456" , "event_time" : 123456789 } The emoji_changed event is sent to all connections for a workspace when that a custom emoji is updated. When they receive this event, clients may either process the subtype if present and of a known value or should update their local cache of emoji by calling the emoji.list method again. An emoji_changed event will always have an event_ts field specified in addition to type . subtype is optional and the presence of additional fields depends on subtype . emoji_changed subtypes ​ An emoji_changed event may have a subtype specified. An absent subtype or unrecognized subtype should be handled by reloading all emojis via the emoji.list method . The following is the current list of defined subtypes: add ​ { "type" : "emoji_changed" , "subtype" : "add" , "name" : "picard_facepalm" , "value" : "https://my.slack.com/emoji/picard_facepalm/db8e287430eaa459.gif" , "event_ts" : "1361482916.000004" } An emoji has been added to the emoji list. Note that, like in emoji.list , value is either the URI to fetch the image from or an alias to an existing name as indicated by the alias: pseudo-protocol. remove ​ { "type" : "emoji_changed" , "subtype" : "remove" , "names" : [ "picard_facepalm" ] , "event_ts" : "1361482916.000004" } One or more emojis have been removed from the emoji list. Note that names is always an array of at least one name, and that aliased emoji entries are always removed when the emoji name they alias to is removed. rename ​ { "type" : "emoji_changed" , "subtype" : "rename" , "old_name" : "grin" , "new_name" : "cheese-grin" , "value" : "https://my.slack.com/emoji/picard_facepalm/db8e287430eaa459.gif" , "event_ts" : "1361482916.000004" } An emoji has been renamed. It will contain the old_name and new_name . Previous email_domain_changed Next entity_comments_requested Copy as markdown * Usage info * emoji_changed subtypes * add * remove * rename . * Tools * Slack CLI * Bolt frameworks * Slack SDKs * Block Kit Builder * Developer program * Code samples & tutorials * LLM? Read llms.txt * All tools Learn * Learning paths * Workshops * Slack certifications * Trailhead * Resource library * All learning resources Community * Slack community * Slack events Resources * Docs * Blog * Slack marketplace * Developer newsletter Manage Apps * Your apps * Status * Privacy * Terms * Cookie Preferences * Support * Changelog * Your Privacy Choices © 2026 Slack Technologies, LLC, a Salesforce company. All rights reserved. Various trademarks held by their respective owners. * * *