Read User

Read an Okta user's system information and profile properties by ID or username. Custom added fields are included in the profile properties.

Note: This action will not read information about application users, attempting to do so will result in a 404 error when the user type is invalid or incorrect. To retrieve details about an application user, use the Custom API Action card. See Application user operations for more information on reading information about assigned users for an application.

Unless otherwise indicated, field types are text.

Input

  • User

    • ID or Login: ID or login username of the Okta user (usually in an email format).

Output

  • System Properties

    • ID: The ID of the Okta user.

    • Status: The current status of the user: STAGED, PROVISIONED, ACTIVE, RECOVERY, LOCKED_OUT, PASSWORD_EXPIRED, SUSPENDED, or DEPROVISIONED.

    • Created (date): The timestamp when the user was created.

    • Activated (boolean): The timestamp when transition to ACTIVE status completed.

    • Status Changed (date): The date of the user's last status change.

    • Last Login (date): The timestamp of the user's last login date.

    • Last Updated (date): The timestamp of the user's last update.

    • Password Changed (date): The timestamp of the user's last password change.

    • Credentials (list)

      • Emails (list): The list of emails associated with the user.

      • Password (boolean): true if the user has a valid password or imported hashed password, false otherwise.

      • Recovery Question (text): The recovery question when a user forgets their password.

      • Provider (object)

        • Name (text): The name of the authentication provider.

        • Type (text): The type of authentication provider; one of: OKTA, ACTIVE_DIRECTORY, LDAP, FEDERATION, SOCIAL or IMPORT.

  • Profile Properties

    • City: The city or locality component of user's address.

    • Cost center: The name of a cost center assigned with the user.

    • Country code: The country abbreviation.

    • Department: The name of user's department.

    • Display name: The name of the user, suitable for display to end users.

    • Division: The name of the user's division,

    • Primary email: The user's primary email address.

    • Employee number: The user's unique identifier assigned to them by the organization or company.

    • First name: The user's first name.

    • Honorific prefix: The user's honorific prefix(es), also known as title in most Western languages

    • Honorific suffix: The user's honorific suffix(es), also known as title in most Western languages.

    • Last name: The user's last name or family name.

    • Locale: The user's default location for purposes of localizing items like currency, date/time format, and numerical representations.

    • Username: The login username of the user, usually in the form of an email address.

    • Manager: The display name of the user's manager.

    • ManagerId: The ID of the user's manager.

    • Middle name: The user's middle name.

    • Mobile phone: The user's mobile phone number.

    • Nickname: The user's preferred nickname, if applicable.

    • Organization: The name of the user's organization.

    • Postal Address: The mailing address component of user's address.

    • Preferred language: The user's preferred written or spoken languages.

    • Primary phone: The primary phone number of the user, such as their home number.

    • Profile Url: The URL of user's online profile (a web page).

    • Secondary email: The secondary email address of the user (typically used for account recovery).

    • State: The state or region component of user's address.

    • Street address: The full street address component of user's address.

    • Time zone: The user's time zone.

    • Title: The user's title, such as Vice President.

    • User type: The user's relationship to the organization, such as Employee or Contractor.

    • Zip code: The zip code or postal code component of the user's address.

    • Custom Profile Properties (dynamically generated): Aditional custom user profile properties that are generated when configuring this card.

See also