Create User

How User Creation Works

The Lynes Loyalty platform uses a streamlined approach to user management. Instead of requiring a separate API call to create users, we automatically create user profiles the first time an event is submitted for a new user ID.

Process Overview

1. You send an event to our API with a unique userId that doesn't exist in our system yet
2. Our platform detects this is a new user and creates a user profile automatically
3. The event is processed and associated with the newly created user
4. Any subsequent events for the same userId will be associated with this user

Example: First Event for a New User

curl -X POST "https://api.lynesloyalty.com/v1/events" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "purchase",
    "user_id": "new_user_123",
    "metadata": {
      "purchase_amount": 49.99,
      "product_id": "prod_abc123"
    }
  }'

In this example, if new_user_123 doesn't exist in our system yet, a new user profile will be automatically created and the purchase event will be associated with this new user.

User Profile Details

When a user is automatically created, we initialize their profile with:

• User ID (from your request)
• Starting point balance of 0
• Timestamp of creation
• Empty history of events