---
title: "Retrieves a map of user IDs to user names and emails."
method: POST
path: "/listActiveUsers"
tags: ["user"]
---

# Retrieves a map of user IDs to user names and emails.

`POST /listActiveUsers`

Search Users by their name or email - lists active users in a slack workspace by their id, name & email. Reutrn a list of users each containing the ID, name, real name, display name, title, and email.

## Request body

- object
  - `body` object — Body of the getActiveUsersIds sls call
    - `arguments` object, required
      - `includeBots` boolean — Whether to include bot users in the list. Defaults to false.
      - `cursor` string — A cursor to the next page of results.
      - `limit` number — The maximum number of users to return.

## Response `200`

Successful response

- object
  - `users` object[]
    - `id` string, required — The ID of the user.
    - `name` string, required — The name of the user.
    - `real_name` string — The real name of the user.
    - `display_name` string — The display name of the user.
    - `title` string — The title of the user.
    - `email` string — The email of the user.
  - `nextCursor` string — A cursor to the next page of results

## Other responses

- `500` — Internal Server Error

## Changes

- **2025-07-25** `dfc356a225b9` — 1 info
  - endpoint added
- **2025-07-18** `8d0d784763dc` — 1 breaking
  - api path removed without deprecation
- **2025-07-16** `f411c95b89fc` — 1 warning, 1 info
  - removed the request property `body/arguments/isBot`
  - added the new optional request property `body/arguments/includeBots`
- **2025-07-16** `6a2873d28ea3` — 3 info
  - added the new optional request property `body/arguments/cursor`
  - added the new optional request property `body/arguments/isBot`
  - added the new optional request property `body/arguments/limit`
- **2025-07-15** `c28a413c6b00` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/microfox-ai/apis/slack-d/changes/listActiveUsers/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)