Customers

Customers (also referred to as External Users) represent the end-users participating in your loyalty programs. Each customer has a unique identity within your project.

Customer Model

Field	Type	Description
id	string	Unique customer identifier
email	string	Customer email address
name	string	Display name
externalId	string	Your system’s user ID
metadata	object	Custom key-value data
createdAt	datetime	When the customer was created

Identifying Customers

Storelayer supports multiple identification strategies:

• Email — Use the customer’s email as the primary identifier
• External ID — Map to your existing user system with externalId
• Storelayer ID — Use the auto-generated unique ID

Note

The externalId field is particularly useful for syncing with your existing user database. It must be unique within a project.

Customer Metadata

Store custom attributes on customer records:

{
  "metadata": {
    "tier": "gold",
    "signup_source": "mobile_app",
    "preferences": {
      "notifications": true,
      "language": "en"
    }
  }
}

Metadata can be used in promotion conditions and workflow triggers.