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.

This action card 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. See Workflows error messages and HTTP status codes.

To retrieve details about an application user, use the Custom API Action card. See Application user operations on reading information about assigned users for an application.

Scopes

See Action cards for the list of required OAuth scopes for this card.

Input

Field Definition Type Required
ID or Login ID or login username of the Okta user (usually in an email format).

Text

TRUE

Output

Field Definition Type

System Properties

ID ID of the Okta user.

Text

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

Text

Created

Date and time when the object was created.

Date & Time

Activated Time stamp when the transition to ACTIVE status completed.

True/False

Status Changed Date of the user's last status change.

Date & Time

Last Login Time stamp of the user's last login date.

Date & Time

Last Updated Time stamp of the user's last update.

Date & Time

Password Changed Time stamp of the user's last password change.

Date & Time

Credentials

Emails List of emails associated with the user.

List

Password True if the user has a valid password or imported hashed password, false otherwise.

True/False

Recovery Question Recovery question when a user forgets their password.

Text

Provider

Name Name of the authentication provider.

Text

Type Type of authentication provider; one of: OKTA, ACTIVE_DIRECTORY, LDAP, FEDERATION, SOCIAL or IMPORT.

Text

Profile Properties

City City or locality component of user's address.

Text

Cost center Name of a cost center assigned with the user.

Text

Country code Country abbreviation.

Text

Department Name of user's department.

Text

Display name Name of the user, suitable for display to end users.

Text

Division Name of the user's division,

Text

Primary email User's primary email address.

Text

Employee number User's unique identifier assigned to them by the organization or company.

Text

First name User's first name.

Text

Honorific prefix User's honorific prefix(es), also known as title in most Western languages

Text

Honorific suffix User's honorific suffix(es), also known as title in most Western languages.

Text

Last name User's last name or family name.

Text

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

Text

Username Login username of the user, usually in the form of an email address.

Text

Manager Display name of the user's manager.

Text

ManagerId ID of the user's manager.

Text

Middle name User's middle name.

Text

Mobile phone User's mobile phone number.

Text

Nickname User's preferred nickname, if applicable.

Text

Organization Name of the user's organization.

Text

Postal Address Mailing address component of user's address.

Text

Preferred language User's preferred written or spoken languages.

Text

Primary phone Primary phone number of the user, such as their home number.

Text

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

Text

Secondary email Secondary email address of the user (typically used for account recovery).

Text

State State or region component of user's address.

Text

Street address Full street address component of user's address.

Text

Time zone User's time zone.

Text

Title

Job title of the user.

Text

User type User's relationship to the organization, such as Employee or Contractor.

Text

Zip code Zip code or postal code component of the user's address.

Text

Custom Profile Properties Additional custom user profile properties that are generated when configuring this card. Various

Related topics

Okta connector

Workflow elements

Guidance for Okta connector

Okta API documentation