This API allows you to attach custom properties at the user level, such as user-level info from your database or demographic info.
Note that these properties are stateless, and only the most recent value is stored. Heap will create a new property if it doesn’t already exist, and will overwrite the previous property value if one already exists with the same name.
The client-side API allows you to add these custom user properties on identified and anonymous users. For best practices and use cases for managing identity, see our developer guide on Using Identify. For a list of questions to consider when deciding what users to track, see the Custom User Properties section of the Setting Up Heap guide.
Our Looker Actions integration allows you to quickly import property data into Heap. See the Looker Actions Integration guide to learn more.