Skip to main content
The three top-level objects in Affinity are Persons, Companies, and Opportunities. (Note: Companies are called Organizations in the Affinity web app.) These have profiles in the Affinity web app and can be added to Lists. A List is a spreadsheet-like collection of rows tied to Persons, Companies, or Opportunities.
  • Each row on a List is a List Entry. A List Entry contains data and metadata about a given Person, Company, or Opportunity in the context of a List. This includes list-specific field data, and information about who added the row to the List and when.
  • A given entity can be added to a List more than once. These List Entries can have different List-specific field data and List Entry-level metadata.
Each column on a List maps to a Field. Fields show up within Affinity profile pages, extensions, and integrations. There are two categories of fields:
  • List-specific fields are scoped to a single List. In the API, their data can only be accessed through the List Entry resource.
  • Global fields belong to entities directly. These can include default fields, fields created by you, enrichment fields, or relationship intelligence fields. They can be accessed through the Person/Company/Opportunity resources and the List Entry resource.