Search Users
Search for one or more users.
Options
Field | Definition | Type | Required |
---|---|---|---|
Return |
Choose from Single user and All matching users.
Single user - If selected, this card returns the first user that matches your search. Use this option when you're looking for a specific user. All matching users - If selected, this card returns a collection of users that match your search. Use this option when you're looking for a filtered set of users. |
Dropdown |
TRUE |
Input
Field | Definition | Type | Required |
---|---|---|---|
User | |||
Name |
Name of the user. |
Text |
FALSE |
External ID |
Unique external ID of the user. |
Text |
FALSE |
Primary email address of the user. |
Text |
FALSE |
|
Phone | Primary phone number of the user. |
Text |
FALSE |
Group | Name of group which the user is associated. |
Text |
FALSE |
Details |
Additional miscellaneous details about the user.
For example, address. |
Text |
FALSE |
Notes | Notes about the user. |
Text |
FALSE |
Organization | Name of organization with which a user is associated. |
Text |
FALSE |
Role | Role of the user. Possible values are "end-user", "agent", or "admin". |
Text |
FALSE |
Tags | Tags for a user. Only present if your account has user tagging available. |
List |
FALSE |
Custom Fields | A dynamically generated list of any custom fields associated with users. More on custom Fields. | Various |
FALSE |
Output
Field | Definition | Type |
---|---|---|
Users | ||
User ID |
Unique identifier of the user. |
Text |
User URL | A URL of the user. |
Text |
Name |
Name of the user. |
Text |
User's primary email address. |
Text |
|
Created At |
Date and time when the object was created. |
Time & Date |
Updated At | Time and date the user was updated. | Time & Date |
Timezone | Time zone of the user; see Time Zone. |
Text |
IANA Timezone | IANA time zone of the user. |
Text |
Phone | Phone number of the user. |
Text |
Shared Phone Number | If true, the phone number is shared. |
True/False |
Locale ID | Language identifier of the user. |
Number |
Locale | Locale of the user; this is a BCP-47 compliant tag. |
Text |
Organization ID | Identification code of the organization to which the user is associated. |
Number |
Role | Role of the user. Possible values are "end-user", "agent", or "admin". |
Text |
Verified? | Identity of the user is verified. If true, user is verified. |
True/False |
External ID |
Unique external ID of the user. |
Text |
Tags | Tags for a user. Only present if your account has user tagging available. |
Text |
Alias | Alias displayed to end users. |
Text |
Active? | If false, the user was deleted. |
True/False |
Shared? | If the user is shared from a different Zendesk Support instance. If true, user is shared. |
True/False |
Shared Agent? | If true, user is a shared agent from another support instance. |
True/False |
Last Login At | Last time the user signed in. |
Date & Time |
Two Factor Auth Enabled | If true, two factor authentication is enabled. |
True/False |
Signature | Signature of the user; only agents and admins have a signature. |
Text |
Details | Additional miscellaneous details about the user, such as an address. |
Text |
Notes | Notes about the user. |
Text |
Role Type | Role type of the user. |
Number |
Custom Role ID | Custom role of the user. |
Number |
Moderator? | If true, the user has forum moderation capabilities. |
True/False |
Ticket Restriction | Specifies tickets to which the user has access. |
Text |
Private Comments Only? | If true, the user can only create private comments. |
True/False |
Restricted Agent? | If true, the agent has restrictions. |
True/False |
Suspended? | If true, the agent is suspended. |
True/False |
Chat Only? | If true, the user is a chat-only agent. |
True/False |
Default Group ID | Default group ID of the user. |
Number |
Report CSV? | If true, the user can access the CSV report. |
True/False |
Custom Fields | A dynamically generated list of any custom fields associated with users. See About custom field types. | Various |