---
title: "Searches for a Slack user by their email address."
method: POST
path: "/getUserByEmail"
tags: ["user"]
---

# Searches for a Slack user by their email address.

`POST /getUserByEmail`

Get a users Information in a Slack workspace using their email address. Returns a comprehensive user object containing detailed information about the found user.

## Request body

- object
  - `body` object — Body of the getUserByEmail sls call
    - `arguments` object, required
      - `email` string, required — The email address of the user to find.

## Response `200`

Successful response

- object
  - `id` string
  - `team_id` string
  - `name` string
  - `deleted` boolean
  - `color` string
  - `real_name` string
  - `tz` string
  - `tz_label` string
  - `tz_offset` integer
  - `profile` object
    - `title` string
    - `phone` string
    - `skype` string
    - `real_name` string
    - `real_name_normalized` string
    - `display_name` string
    - `display_name_normalized` string
    - `fields` object
    - `status_text` string
    - `status_emoji` string
    - `status_expiration` integer
    - `avatar_hash` string
    - `start_date` string
    - `image_original` string
    - `is_custom_image` boolean
    - `email` string
    - `pronouns` string
    - `first_name` string
    - `last_name` string
    - `image_24` string
    - `image_32` string
    - `image_48` string
    - `image_72` string
    - `image_192` string
    - `image_512` string
    - `image_1024` string
    - `status_text_canonical` string
    - `team` string
  - `is_admin` boolean
  - `is_owner` boolean
  - `is_primary_owner` boolean
  - `is_restricted` boolean
  - `is_ultra_restricted` boolean
  - `is_bot` boolean
  - `is_app_user` boolean
  - `updated` string
  - `is_email_confirmed` boolean
  - `who_can_share_contact_card` string
  - `enterprise_user` object

## Other responses

- `400` — Bad request - invalid email format or missing email
- `404` — User not found
- `500` — Server error

## Changes

- **2025-07-18** `8d0d784763dc` — 1 info
  - endpoint added
- **2025-06-20** `37c50ff8be3a` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/microfox-ai/apis/slack-d/changes/getUserByEmail/post.md)

---

[API](https://skmtc.dev/microfox-ai/apis/slack-d.md) · [All operations](https://skmtc.dev/microfox-ai/apis/slack-d/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/microfox-ai/slack-d/revisions/cd0edf0c2cdf/schema)