All tools
C
by Clerk
List users
Returns the application's users, newest first, filtered by email, name, organization or sign-up, sign-in and last-active dates.
Updated Sep 29, 2026
list-users.md
List users
Returns the application's users, newest first, filtered by email, name, organization or sign-up, sign-in and last-active dates.
Set up
Use the first option your agent supports.
CLI (official)
Install the command and sign in with it, then confirm it runs.
npm install -g clerk
clerk --version
Run clerk users list.
API (official)
- Base URL: https://api.clerk.com/v1
- Endpoint:
GET /users - Auth: send the header
Authorization: Bearer $CLERK_SECRET_KEY - Get a key: https://dashboard.clerk.com/~/api-keys
- Docs: https://clerk.com/docs/reference/backend-api
Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.
