What are Entities
An entity is an object that maintains and stores the most up-to-date information about a specific item or record in your system. Entities represent different objects like orders or meetings, and are created and modified by events that occur within your connected applications.
Entities are a base layer and you cannot configure or define Entities as they are created automatically through the connections that you have set up. When events occur within your connected applications, entities are generated or updated to reflect the current state of these objects.
Understanding Entities
Configuration / Definition
Entity definitions are read-only and cannot be modified after they are created. These entities are always tracked against entity definitions that are pre-configured and created automatically through your connected applications. Each entity definition is directly tied to a connection and contains information about the object it is capturing.
Attributes
Each entity contains multiple entity attributes that display information about the object. It encapsulates the current state and details of the entity at any given time. For instance, in the case of an Order entity, the entity attributes would contain information like the order ID, order timestamp, and any other relevant details. You can find these in the Attributes tab.
The combination of the Entities configuration and attributes helps maintain an accurate representation of objects in your system. As every entity holds attributes specific to its type, you can use this information to track and analyze objects based on the more specific information it holds.
Types of Entities
Here are some examples for Entity configurations and attributes (there are more):
Configuration
Shopify Order
Shopify Customer
Shopify Order Line Item
Klaviyo Lead
Meeting
Attributes
Fulfillment Costs
Product Costs
Fixed Transaction Costs
Variable Transaction Costs
Creating Entities & Entity Attributes
As described before, you cannot create Entity Definitions as these are automatically created when setting up a new connection. All entity definitions are predefined and directly tied to a connection.
However, you can create custom attributes for entities to make specific data, metrics or filters available in your dashboards. For more information on which data you can make available and how, read: Create Custom Entity Attributes.