Step 3 - Create a managed user

A managed user represents one of your customers in Lightyear. It's where we store their integration credentials and manage their data syncing.

Navigate to managed users

First, go to the Managed Users section in your dashboard:

Create a new managed user

Click the "Create managed user" button:

Enter user details

Fill in the form with:

• External ID: A unique identifier from your system (e.g., "hubspot-test-user")
• Display Name: A friendly name to help you identify this user (e.g., "HubSpot Test User")

Understanding managed users

Managed users are a core concept in Lightyear:

• They represent your customers
• Each user can have multiple integrations
• Credentials are stored securely per user
• API calls are made on behalf of specific users

In production, you'd typically create managed users programmatically via the API when customers sign up for integrations in your product.

What's next?

Great! You've created a managed user. Now let's add the HubSpot integration to this user.