Search Users

Search a user in Freshservice.

Options

Field	Definition	Type	Required
Result Set	Choose one of the following options to display your search results: First Matching User: returns a single user record Stream Matching Users: pass all matching user records from your parent flow to a helper flow; a Streaming input section will be added to the card from which you can select a helper flow for streaming and adding custom extensible fields.	Dropdown	TRUE

Field

Definition

Type

Required

Result Set

Choose one of the following options to display your search results:

First Matching User: returns a single user record
Stream Matching Users: pass all matching user records from your parent flow to a helper flow; a Streaming input section will be added to the card from which you can select a helper flow for streaming and adding custom extensible fields.

Dropdown

TRUE

To learn how to use the Stream Matching Users option and set up a helper flow to return a large number of records, see Stream matching records with a helper flow.

Field	Definition	Type	Required
Filter By	Filter users by Email, Phone, or Mobile.	Dropdown	TRUE
Value	The value to match to the selected filter type. For example, match all Phone entries that have the value 5555551234. Only enter the digits of phone numbers. Don't enter any other symbols or special characters such as parentheses (), plus signs (+), or dashes (-).	Text	TRUE
State	Filter users by their state: All, Verified, Unverified, Deleted, or Blocked. Deleted users are not returned when the filter is set to All. Choose Deleted to search deleted users.	Dropdown	TRUE
Streaming
Flow	Click Choose Flow to browse and select a helper flow to which the search results will be streamed, then click Choose to confirm. Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow.	Flow	FALSE

Field	Definition	Type
User
Active	Indicates if the user is active.	True/False
First Name	First name of the user.	Text
Last Name	Last name of the user.	Text
Address	User's address.	Text
Created At	Date and time when the object was created.	Date & Time
Description	Description of the user.	Text
Email	User's email address.	Text
Secondary Emails	Additional emails associated with the user.	List of Text
External ID	Unique external ID of the user.	Text
User ID	Unique identifier of the user.	Number
Has Logged In	True if the user has logged in to Freshservice; otherwise False.	True/False
Reporting Manager ID	User ID of the user's reporting manager.	Text
Helpdesk Agent	Indicates if the user is a helpdesk agent.	True/False
Job Title	User's job title.	Text
Language	User's language.	Text
Mobile	User's mobile number.	Text
Phone	User's phone number.	Text
Time Zone	User's time zone.	Text
Time Format	User's time format (12H or 24H).	Text
Location ID	Unique ID for the location associated with the user.	Text
Updated At	Date and time that the user was last updated.	Date & Time
Department Names	List of department names associated with the user.	List of Text
Department IDs	Unique IDs of the departments associated with the requester.	List of Numbers
View All Associated Department Tickets	True if the requester is allowed to view tickets filed by other members of the department; otherwise False.	True/False
Custom Fields	Custom fields containing additional user information specific to your organization.	Various