HubSpot entities
This article describes the entities (objects) of the HubSpot CRM system available for use in LightLead.
Available entities
HubSpot provides: deal — the main entity, accessed via /crm/v3/objects/deals/search. Related contact and company are available via the associations API (optional). Deal search is done via the search endpoint with filtering.
Entity structure
Each entity in LightLead is represented as follows:
Entity name — the display name
System name — the identifier used in the API and reports
Base fields — standard fields provided by the CRM
Custom fields — fields created by the user in the CRM
Relations — links to other entities (contacts, companies, etc.)
Relationships between entities
| Parent entity | Child entity | Relationship type |
|---|---|---|
| deal | Related data | One-to-many |
| contact | Related data | One-to-many |
| company | Related data | One-to-many |
Entity details
deal
The deal entity contains base fields and custom fields. The full list of fields is available on the Fields page.
contact
The contact entity contains base fields and custom fields. The full list of fields is available on the Fields page.
company
The company entity contains base fields and custom fields. The full list of fields is available on the Fields page.
Use in reports
When creating a report, you choose a primary entity. Related data (contacts, companies) is available through the primary entity's fields or by joining data.
Important
When an entity is deleted in the CRM, it is marked as inactive in LightLead
Historical data for deleted entities is preserved
New entities become available after discovery is run again
Related pages
Fields — description of all fields