From 49767a03c8f35e1ad728a5e7a0c6563d96f87c7b Mon Sep 17 00:00:00 2001
From: William Bergamin <wbergamin@slack-corp.com>
Date: Fri, 16 Oct 2026 11:29:59 -0400
Subject: [PATCH] feat(types): add the user_connection_status_requested event

Slack sends this event when it has no connection status for a user, so
apps answer with apps.user.connection.update. Adding it to SlackEvent
types the event in Bolt listeners.
---
 .changeset/user-connection-status-requested-event.md |  5 +++++
 packages/types/src/events/index.ts                   |  9 ++++++++-
 packages/types/src/events/user.ts                    |  5 +++++
 packages/types/test/events/user.test-d.ts            | 12 ++++++++++++
 4 files changed, 30 insertions(+), 1 deletion(-)
 create mode 100644 .changeset/user-connection-status-requested-event.md
 create mode 100644 packages/types/test/events/user.test-d.ts

diff --git a/.changeset/user-connection-status-requested-event.md b/.changeset/user-connection-status-requested-event.md
new file mode 100644
index 000000000..f368bb275
--- /dev/null
+++ b/.changeset/user-connection-status-requested-event.md
@@ -0,0 +1,5 @@
+---
+"@slack/types": minor
+---
+
+feat(types): add the [`user_connection_status_requested`](https://docs.slack.dev/reference/events/user_connection_status_requested) event interface
diff --git a/packages/types/src/events/index.ts b/packages/types/src/events/index.ts
index a3dddebe2..ff93ff535 100644
--- a/packages/types/src/events/index.ts
+++ b/packages/types/src/events/index.ts
@@ -87,7 +87,13 @@ import type {
   TeamRenameEvent,
 } from './team';
 import type { TokensRevokedEvent } from './token';
-import type { UserChangeEvent, UserHuddleChangedEvent, UserProfileChangedEvent, UserStatusChangedEvent } from './user';
+import type {
+  UserChangeEvent,
+  UserConnectionStatusRequestedEvent,
+  UserHuddleChangedEvent,
+  UserProfileChangedEvent,
+  UserStatusChangedEvent,
+} from './user';
 
 export * from './agent';
 export * from './app';
@@ -205,6 +211,7 @@ export type SlackEvent =
   // TODO: url_verification event is missing, but maybe we don't need it?
   // NOTE: url_verification does not use the envelope, but it's also not interesting for an app developer. it's omitted.
   | UserChangeEvent
+  | UserConnectionStatusRequestedEvent
   | UserHuddleChangedEvent
   | UserProfileChangedEvent
   | UserStatusChangedEvent
diff --git a/packages/types/src/events/user.ts b/packages/types/src/events/user.ts
index 3c5b61f2f..a45c97c45 100644
--- a/packages/types/src/events/user.ts
+++ b/packages/types/src/events/user.ts
@@ -82,6 +82,11 @@ export interface UserChangeEvent {
   event_ts: string;
 }
 
+export interface UserConnectionStatusRequestedEvent {
+  type: 'user_connection_status_requested';
+  user: string;
+}
+
 export interface UserHuddleChangedEvent {
   type: 'user_huddle_changed';
   user: {
diff --git a/packages/types/test/events/user.test-d.ts b/packages/types/test/events/user.test-d.ts
new file mode 100644
index 000000000..d1a1f0157
--- /dev/null
+++ b/packages/types/test/events/user.test-d.ts
@@ -0,0 +1,12 @@
+import { expectAssignable, expectError } from 'tsd';
+import type { SlackEvent, UserConnectionStatusRequestedEvent } from '../../src/index';
+
+const statusRequested: UserConnectionStatusRequestedEvent = {
+  type: 'user_connection_status_requested',
+  user: 'U0123456789',
+};
+expectAssignable<SlackEvent>(statusRequested);
+
+expectError<UserConnectionStatusRequestedEvent>({
+  type: 'user_connection_status_requested',
+});