People represent the end users in your system. A person is the individual you want to track, analyze, and associate with events. Every event should be tied to a person so you can understand usage, behavior, and outcomes at the user level.

A person ID is a unique identifier for each individual. This can be your internal user ID, an email address, or any other stable unique identifier from your system. The same person ID should always refer to the same individual.

You can explicitly create a person using the SDK by providing a unique person ID and optional metadata. If a person with the same ID already exists, the SDK will return the existing record instead of creating a duplicate.

When creating an event, you can provide a person ID directly. If the person does not already exist, it will be created automatically. This allows you to avoid managing person creation separately.

In some systems, your direct customer may have their own end users. In this case, you can model each end user as a separate person while using metadata to associate them with a parent account, organization, or tenant. This allows you to track activity at both the individual and account level.