Search Users

Search for Salesforce users by username or email.

Unless otherwise indicated, field types are text.


  • Search By

    • Username: The user's username.

    • Email: The user's email address.


  • Query

    • Value: The exact value you want to search for (cannot be a partial search).


  • Result

    • Search By Username:

      • User ID: The unique identifier of the user.

      • First Name: The user's first name.

      • Last Name: The user's last name.

      • Username: The user's unique login in the form of an email address.

      • Email: The user's email address.

      • Is Active? (boolean): True if the user is active; false, otherwise.

      • Is Frozen? (boolean): True if the user is frozen; false, otherwise.

      • Alias: A short name to identify the user on pages where the entire name does not fit (if no value is provided, alias is generated based on the Username, trimmed to eight characters).

      • Nickname: The name used to identify user in a community.

      • Title: The user's job title.

      • Email Encoding (drop-down): The character set and encoding for outbound email sent by user, defaulted to Unicode (UTF-8)

      • Locale: The user's country or geographic region, defaulted to en_US. See Supported Formats for more information on locales.

      • Language (drop-down): The user's primary language.

      • Mobile Phone: The user's cellular or mobile phone number.

      • Phone: The user's phone number.

      • City: The city portion of user's address.

      • State/Province: The state or province portion of the user's address.

      • Zip/Postal Code: The zip code or postal code portion of the user's address.

      • Employee Number: A unique identification number for the user.

      • Company Name: The name of the user's company.

      • Division: The division of the company (for example, PC Sales Group).

      • Department: The department or group in the company (for example, Customer Support).

      • Manager ID: The unique identifier of the user's manager.

    • Search By Email:

      • Users (collection): A list of matching user objects.

See also