Search Zendesk Users
search_usersFind Zendesk users by name, email, role, or organization and return each match's ID and profile details, so you can confirm the right person and obtain the numeric user ID needed by other tools.
Instructions
Search for users by name, email, or other criteria using Zendesk search query syntax, returning each match's id, name, email, role, active flag and organization id, with the total count. Use it to turn a person into the numeric user id other tools take, such as the followers of update_ticket; a name can match several users, so confirm the right one. With an id already in hand, call get_user to read that one user, and for your own account get_current_user. Prefer it over search when you want users only: search mixes in tickets and organizations unless the query says type:user.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number for offset pagination. Increment it while keeping `per_page` fixed to fetch subsequent pages; page 1 is the first page. | |
| query | Yes | Zendesk user search query — free text matched against name and email, and/or field filters like "email:jane@acme.com", "role:agent", "organization_id:123". A "type:user" scope is added automatically. | |
| per_page | No | Number of results per page for offset pagination (1-100). Pair with `page` to walk large result sets; the response header reports the total count and whether more pages remain. |