Skip to content

Pipedrive Entities

This article describes the entities (objects) of the Pipedrive CRM system available for use in LightLead.

Available entities

Pipedrive provides three related entities: deal (the primary one), person, and organization. They're linked via deal.person_id and deal.organization_id. All three types have their own base and custom fields.

Entity structure

Each entity is represented in LightLead 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 entityChild entityRelationship type
dealRelated dataOne-to-many
personRelated dataOne-to-many
organizationRelated dataOne-to-many

Entity details

deal

The deal entity contains base fields and custom fields. The full field list is available on the Fields page.

person

The person entity contains base fields and custom fields. The full field list is available on the Fields page.

organization

The organization entity contains base fields and custom fields. The full field list is available on the Fields page.

Use in reports

When creating a report, you select the main entity. Related data (contacts, companies) is available via the main entity's fields or by joining data.

Important

  • When an entity is deleted in the CRM, it's marked as inactive in LightLead

  • Historical data for deleted entities is preserved

  • New entities become available after discovery is run again

Maintained by the LightLead Documentation Team · Last verified: 2026-07-26