channel_id_changed event

A channel ID changed

Compatibility: Events API

Expected scopes:

{
  "type": "channel_id_changed",
  "old_channel_id": "G012Y48650T",
  "new_channel_id": "C012Y48650T",
  "event_ts": "1612206778.000000"
}

A channel_id_changed event is sent when a user initiates sharing a private channel externally with Slack Connect. When a private channel is shared, the existing private channel's unique channel ID changes to a new identifier permanently. This event is only sent for private channels your app has access to.

When receiving this event, you should update any records you have stored about the original private channel ID (old_channel_id) with this new_channel_id. From now on, all messages and other happenstance around the channel will be associated with the new ID. If you attempt to post messages, perform lookups, or other operations with the channel you will need the channel's new ID.

While there are other reasons a channel ID may change, this event currently applies to only the circumstances with Slack Connect described above.

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.

Unavailable in the RTM API

This event type is compatible only with the Events API.

Was this page helpful?