Okta Workflows how-to guides are questions and answers from weekly community office hours, MacAdmins Workflows Slack channel, and other places. Read all other how-to guides.
On to the question.
How to read a custom user profile attribute?
If you prefer a video, jump to the end of this blog post to watch a short video about this question and answer.
Okta user types
Okta has a built-in default user type and allows to create custom user types.
From the Admin dashboard, go to Directory > Profile Editor. You will see one or more user types listed (you might have more than two listed). In the screenshot below, two user types are shown:
- User (default) – this is the default user type
- Atko User – this is a custom user type
You will first learn how to read a custom attribute on the default user type.
Reading a custom attribute on the default user type
Clicking on User (default) opens up a profile editor shown below.
On the left side, you see All attributes, Base attributes, or only Custom attributes. In this example, you have added one custom attribute to the default user type:
- LinkedIn profile
User Stella Green has the default user type, and has the LinkedIn profile custom attribute set:
The custom attribute is on the default user type, you use Okta – Read User card to read the user information, including the custom attribute.
As the custom attribute is on the default user type, you can choose to show the field from ⚙️ > Choose fields:
Running the flow shows the custom LinkedIn profile attribute:
Reading a custom attribute on a custom user type
Now, let’s learn how to read a custom attribute on a custom user type.
Click on the custom Atko User user type:
This custom user has one custom attribute, Portfolio URL:
User Irene Johnson has a custom user type:
Irene also has the Portfolio URL custom attribute set:
If you use the Okta – Read User card, the card doesn’t know about the custom user type and doesn’t know about the custom attribute. The Read User card only knows about the built-in default user type.
The solution is to use a Custom API Action card to read a custom attribute on a custom user type.
Reading a custom attribute on a custom user type with a Custom API Action card
Use Okta’s Custom API Action card to read user information, whether it’s the default user type or a custom user type.
Make an API call to this endpoint:
This is a flow to read user information:
In the above flow:
- The Assign card sets the user ID
- The Concatenate card appends the user ID to the end point (
- The Custom API Action makes an API call
- The Get Multiple card retries the Portfolio URL attribute
Learn how to use the Custom API Action card:
How to Call an API When It’s Not Available From an Existing Card (Connection)
Watch a short video about this question and answer.
What you learned
In this blog post, you learned how to read a custom attribute on the default user type and on a custom user type.
More resources to help you learn:
🍫 Get help from Workflows specialists during weekly community office hours.
📺 Learn from short Workflows videos.
🙋🏻♀️ Join the #okta-workflows channel on MacAdmins Slack to learn and get help from the community
Leave a Reply