From 33070c356c2f5fc1034ba3b23412dfc5e52a8483 Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Tue, 10 Mar 2026 16:13:01 -0700
Subject: [PATCH 1/2] feat(slack): add email field to get user and list users
 tools

---
 apps/docs/content/docs/en/tools/slack.mdx |  2 ++
 apps/sim/lib/oauth/oauth.ts               |  1 +
 apps/sim/lib/oauth/utils.ts               |  1 +
 apps/sim/tools/slack/get_user.ts          |  1 +
 apps/sim/tools/slack/list_users.ts        |  1 +
 apps/sim/tools/slack/types.ts             | 11 +++++++++++
 6 files changed, 17 insertions(+)

diff --git a/apps/docs/content/docs/en/tools/slack.mdx b/apps/docs/content/docs/en/tools/slack.mdx
index 7ecfe09fe0e..f89be8ef04c 100644
--- a/apps/docs/content/docs/en/tools/slack.mdx
+++ b/apps/docs/content/docs/en/tools/slack.mdx
@@ -590,6 +590,7 @@ List all users in a Slack workspace. Returns user profiles with names and avatar
 |   ↳ `name` | string | Username \(handle\) |
 |   ↳ `real_name` | string | Full real name |
 |   ↳ `display_name` | string | Display name shown in Slack |
+|   ↳ `email` | string | Email address \(requires users:read.email scope\) |
 |   ↳ `is_bot` | boolean | Whether the user is a bot |
 |   ↳ `is_admin` | boolean | Whether the user is a workspace admin |
 |   ↳ `is_owner` | boolean | Whether the user is the workspace owner |
@@ -629,6 +630,7 @@ Get detailed information about a specific Slack user by their user ID.
 |   ↳ `title` | string | Job title |
 |   ↳ `phone` | string | Phone number |
 |   ↳ `skype` | string | Skype handle |
+|   ↳ `email` | string | Email address \(requires users:read.email scope\) |
 |   ↳ `is_bot` | boolean | Whether the user is a bot |
 |   ↳ `is_admin` | boolean | Whether the user is a workspace admin |
 |   ↳ `is_owner` | boolean | Whether the user is the workspace owner |
diff --git a/apps/sim/lib/oauth/oauth.ts b/apps/sim/lib/oauth/oauth.ts
index 0e0221d743c..4eebc0f5849 100644
--- a/apps/sim/lib/oauth/oauth.ts
+++ b/apps/sim/lib/oauth/oauth.ts
@@ -639,6 +639,7 @@ export const OAUTH_PROVIDERS: Record<string, OAuthProviderConfig> = {
           'im:history',
           'im:read',
           'users:read',
+          'users:read.email',
           'files:write',
           'files:read',
           'canvases:write',
diff --git a/apps/sim/lib/oauth/utils.ts b/apps/sim/lib/oauth/utils.ts
index 6cdee0220ed..5b8c23d7ea4 100644
--- a/apps/sim/lib/oauth/utils.ts
+++ b/apps/sim/lib/oauth/utils.ts
@@ -269,6 +269,7 @@ export const SCOPE_DESCRIPTIONS: Record<string, string> = {
   'im:history': 'Read direct message history',
   'im:read': 'View direct message channels',
   'users:read': 'View workspace users',
+  'users:read.email': 'View user email addresses',
   'files:write': 'Upload files',
   'files:read': 'Download and read files',
   'canvases:write': 'Create canvas documents',
diff --git a/apps/sim/tools/slack/get_user.ts b/apps/sim/tools/slack/get_user.ts
index bc0d803e6b6..4897e5fd835 100644
--- a/apps/sim/tools/slack/get_user.ts
+++ b/apps/sim/tools/slack/get_user.ts
@@ -85,6 +85,7 @@ export const slackGetUserTool: ToolConfig<SlackGetUserParams, SlackGetUserRespon
           first_name: profile.first_name || '',
           last_name: profile.last_name || '',
           title: profile.title || '',
+          email: profile.email ?? null,
           phone: profile.phone || '',
           skype: profile.skype || '',
           is_bot: user.is_bot || false,
diff --git a/apps/sim/tools/slack/list_users.ts b/apps/sim/tools/slack/list_users.ts
index e6ba20e71ed..60e36c4bf21 100644
--- a/apps/sim/tools/slack/list_users.ts
+++ b/apps/sim/tools/slack/list_users.ts
@@ -93,6 +93,7 @@ export const slackListUsersTool: ToolConfig<SlackListUsersParams, SlackListUsers
         name: user.name,
         real_name: user.real_name || user.profile?.real_name || '',
         display_name: user.profile?.display_name || '',
+        email: user.profile?.email ?? null,
         is_bot: user.is_bot || false,
         is_admin: user.is_admin || false,
         is_owner: user.is_owner || false,
diff --git a/apps/sim/tools/slack/types.ts b/apps/sim/tools/slack/types.ts
index d16b3a27e67..c328904e6a5 100644
--- a/apps/sim/tools/slack/types.ts
+++ b/apps/sim/tools/slack/types.ts
@@ -376,6 +376,11 @@ export const USER_OUTPUT_PROPERTIES = {
   title: { type: 'string', description: 'Job title', optional: true },
   phone: { type: 'string', description: 'Phone number', optional: true },
   skype: { type: 'string', description: 'Skype handle', optional: true },
+  email: {
+    type: 'string',
+    description: 'Email address (requires users:read.email scope)',
+    optional: true,
+  },
   is_bot: { type: 'boolean', description: 'Whether the user is a bot' },
   is_admin: { type: 'boolean', description: 'Whether the user is a workspace admin' },
   is_owner: { type: 'boolean', description: 'Whether the user is the workspace owner' },
@@ -438,6 +443,11 @@ export const USER_SUMMARY_OUTPUT_PROPERTIES = {
   name: { type: 'string', description: 'Username (handle)' },
   real_name: { type: 'string', description: 'Full real name' },
   display_name: { type: 'string', description: 'Display name shown in Slack' },
+  email: {
+    type: 'string',
+    description: 'Email address (requires users:read.email scope)',
+    optional: true,
+  },
   is_bot: { type: 'boolean', description: 'Whether the user is a bot' },
   is_admin: { type: 'boolean', description: 'Whether the user is a workspace admin' },
   is_owner: { type: 'boolean', description: 'Whether the user is the workspace owner' },
@@ -953,6 +963,7 @@ export interface SlackUser {
   title?: string
   phone?: string
   skype?: string
+  email?: string | null
   is_bot: boolean
   is_admin: boolean
   is_owner: boolean

From 2874e9149fa935b2f204d3757158754962c59a4d Mon Sep 17 00:00:00 2001
From: Waleed Latif <walif6@gmail.com>
Date: Tue, 10 Mar 2026 16:27:16 -0700
Subject: [PATCH 2/2] fix(slack): use empty string fallback for email and make
 type non-optional

---
 apps/sim/tools/slack/get_user.ts   | 2 +-
 apps/sim/tools/slack/list_users.ts | 2 +-
 apps/sim/tools/slack/types.ts      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/apps/sim/tools/slack/get_user.ts b/apps/sim/tools/slack/get_user.ts
index 4897e5fd835..e63915f844f 100644
--- a/apps/sim/tools/slack/get_user.ts
+++ b/apps/sim/tools/slack/get_user.ts
@@ -85,7 +85,7 @@ export const slackGetUserTool: ToolConfig<SlackGetUserParams, SlackGetUserRespon
           first_name: profile.first_name || '',
           last_name: profile.last_name || '',
           title: profile.title || '',
-          email: profile.email ?? null,
+          email: profile.email || '',
           phone: profile.phone || '',
           skype: profile.skype || '',
           is_bot: user.is_bot || false,
diff --git a/apps/sim/tools/slack/list_users.ts b/apps/sim/tools/slack/list_users.ts
index 60e36c4bf21..f0df5f93961 100644
--- a/apps/sim/tools/slack/list_users.ts
+++ b/apps/sim/tools/slack/list_users.ts
@@ -93,7 +93,7 @@ export const slackListUsersTool: ToolConfig<SlackListUsersParams, SlackListUsers
         name: user.name,
         real_name: user.real_name || user.profile?.real_name || '',
         display_name: user.profile?.display_name || '',
-        email: user.profile?.email ?? null,
+        email: user.profile?.email || '',
         is_bot: user.is_bot || false,
         is_admin: user.is_admin || false,
         is_owner: user.is_owner || false,
diff --git a/apps/sim/tools/slack/types.ts b/apps/sim/tools/slack/types.ts
index c328904e6a5..9c8997c2c37 100644
--- a/apps/sim/tools/slack/types.ts
+++ b/apps/sim/tools/slack/types.ts
@@ -963,7 +963,7 @@ export interface SlackUser {
   title?: string
   phone?: string
   skype?: string
-  email?: string | null
+  email: string
   is_bot: boolean
   is_admin: boolean
   is_owner: boolean