How Profile Enrichment can boost your product

Explore how enriching user profiles work, their benefits, and how you can enable it using Authgear to boost your product usage by understanding who your customers are.

 min. read
Last updated:
August 8, 2023

Sometimes, your business may need more details about your users than what they provide when they first sign up or log in. But how do you get these details? It wouldn't be good to keep asking your users for the same information every time they log in, as that would make their experience less enjoyable. Also, it's not practical or efficient for someone in your company to search for and add extra information to each user's profile manually. In such cases, the Profile Enrichment method can help in finding and adding information that is publicly available to a user's profile.

In this post, we'll explore how enriching user profiles work, their benefits, and how you can enable it using Authgear to boost your product usage by understanding who your customers are.

What is Profile Enrichment?

Profile enrichment, as the name suggests, means making your current customer data better by adding more details from outside sources. It's all about bringing in extra information about your customers from other places and mixing it with the basic data you already have. For example, when a user logs in or during the sign-up process, you can request public Geolocation API to capture more information about the user’s country, city, or time zone by using their IP address.

Boosting product value with Profile Enrichment

There are a lot of benefits of using profile enrichment practice, here are some of them you might think of:

  1. Personalization: Personalization is more than just a trend – it's a necessity in the current business environment. For instance, if you know your customer's job titles or the industry they work in, you can create hyper-personalized communication and experiences that speak directly to their needs and interests.
  2. Increased Customer Engagement: Profile enrichment provides deeper insights into user behaviors, preferences, and lifestyles. These insights can then be used to create strategies that will increase user engagement. This might include sending personalized emails, displaying relevant product recommendations, or designing user interface enhancements based on user behaviors and preferences.
  3. Better Segmentation: With enriched user profiles, segmentation becomes more accurate and insightful. Companies can segment users based on their demographic information, behavior, interests, or preferences. This enhanced segmentation can lead to more effective marketing campaigns, improved user experience, and ultimately, higher conversion rates.
  4. Improved Customer Retention: Understanding your customer is key to retaining them. Profile enrichment offers a deeper understanding of your users, allowing you to proactively address issues, predict future behavior, and offer products or services tailored to their needs, leading to increased customer satisfaction and loyalty.

How to enable profile enrichment with Authgear?

For profile enrichment with Authgear, you create a Hook that could call an external API such as FullContact and Clearbit to grab some data and then put any extra information into the User Profile that every user gets when they sign up through Authgear. You could also integrate that data with the profile custom attributes of existing users who are logging in but are missing that information.

Hooks are snippets of code in JavaScript / TypeScript that run at specific Events in the identity workflow, such as when the user logs in or signs up for an account or updates their profile a new event is triggered.

By default, Authgear has standard attributes which contain basic info, such as name, email, and timestamp of the user's latest login, in pre-defined attributes of OIDC specification. See the full list of attributes here. You can access user profiles in different ways and you add new attributes to the custom attributes section both in the Authgear and programmatically using Hooks.

Example of profile enrichment with Authgear

Suppose you wanted to gather more detailed information about your users than the basic details they gave when they first registered for their accounts. In this case, you could use a Hook. This Hook could activate right after a user creates an account (using user.pre_create event), and it would link to location data APIs to collect more demographic data about them: city, country, and timezone. This Hook would then put this extra information into the user's profile custom attributes. Here are easy steps on how to achieve this:

Step 1. Make sure that you have an Authgear account. If you don't have one, you can create it for free on the Authgear website. Start by logging into your Authgear dashboard. This is your command center for managing authentication for your apps.

Step 2. Go to User ProfileCustom Attributes page.

Step 3. Add 3 new attributes there, namely city, name, and timezone:

Step 4. Navigate to your Authgear Dashboard's Advanced->Hooks section.

Step 5. Add a new Blocking Event.

Step 6. Choose the Block Hook Type as the TypeSctipt and set the Event option to User pre-create. You will write a new             Typescript function from scratch.

Step 7. Click on Edit Script under the Config option.

Step 8. Write a function logic for how you integrate any external API to populate custom attributes into the editor. For example.

export default async function(e: EventUserPreCreate): Promise
  // API Key for IP Geolocation
  const apiKey = 'MY_API_KEY';
  // Any random IP address
	const ipAddress = '' 

  // Fetch data from the IP Geolocation API
  const response = await fetch(`${apiKey}&ip=${ipAddress}`);
  const data = await response.json();

return {
    is_allowed: true,
      user: {
          custom_attributes: {
            "country": data.country_name,

Step 9. Now if you navigate to User Management and Add a new user.

Step 10. After the user is created, you should able to see custom attributes values have been updated for the user:

Progressive Profiling

Asking for too much information all at once can overwhelm users. Progressive profiling is another smart way to learn more about your customers. Rather than bombarding your users with lots of questions when they first sign up, you simply ask them a couple of questions each time they log in or update their user profile. Using progressive profiling with Authgear makes things better for your users by making sign-up forms shorter, not asking the same questions over and over, gathering more useful information, and helping more users complete sign-up.


Profile Enrichment, when used effectively, can offer significant benefits to businesses. It enables deeper connections with customers, leading to improved user experiences, more effective marketing, and increased customer loyalty.

Related resources

Recommended content