Skip to main content

Identify users

Identifying Users​

The Identify call links a user to their actions and records relevant traits, such as their email, name, user ID, and other details.

Identifying Users in Your App​

Use the identify function to associate user data with their interactions:

told('identify', {{DATA}});

Example:

told('identify', {
  id: 'xcv45ydsqwvxdx',
  email: '[email protected]',
  firstName: 'Toto',
  lastName: 'Toto',
});

When to Make an Identify Call​

It’s recommended to trigger an Identify call in the following scenarios:

  • When a user registers for the first time
  • When a user logs in
  • When a user updates their information (e.g., changing or adding an address)

⚠️ Important: The id field must be unique and serve as an identifier.

Logging Out a User​

To clear a user's session and reset their identity, call the reset function.