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