Affinity
for LuumenAI

Affinity helps private capital investors to find, manage, and close more deals

Operate Affinity from the same conversation as the hosts it runs on. Check jobs, queues, and interfaces without a second console; run diagnostic reports; and restart or update with the change previewed, approved, and logged.

The Affinity toolbox

20 tools, all read-only. They answer instantly, and every call is logged.

  • ReadGet a company s list entriesSummarize company data across all lists, including list-specific fields and metadata like creation date and author.
  • ReadGet a company s listsReturns metadata for all the Lists on which the given Company appears.
  • ReadGet all companiesAffinity API allows paginated access to company info and custom fields.
  • ReadGet all list entries on a listAccess and export essential data and metadata for Companies, Persons, or Opportunities from a List, specifying data via `fieldIds` or `fieldTypes`.
  • ReadGet all list entries on a saved viewUse the endpoint to access rows in a Saved View with specific filters and selected fields from a web app.
  • ReadGet all opportunitiesPagination through Opportunities in Affinity yields basic info but excludes field data.
  • ReadGet all personsThe Affinity API offers paginated access to Person data using `fieldIds` or `fieldTypes`.
  • ReadGet a person s list entriesSummary: Browse rows for a Person in all Lists, showing field data and entry metadata like creation time and author.
  • ReadGet a person s listsReturns metadata for all the Lists on which the given Person appears.
  • ReadGet a single companyRetrieve basic company info and specific field data by using `fieldIds` or `fieldTypes` parameters.
  • ReadGet a single opportunityGet basic details about an Opportunity without field data via provided endpoints.
  • ReadGet a single personUse GET `/v2/persons/fields` with `fieldIds` or `fieldTypes` for detailed data; basic info by default.
  • ReadGet current userReturns metadata about the current user.
  • ReadGet metadata on all listsReturns metadata on Lists.
  • ReadGet metadata on a single listReturns metadata on a single List.
  • ReadGet metadata on a single list s fieldsReturns metadata on the Fields available on a single List.
  • ReadGet metadata on a single saved viewReturns metadata on a single Saved View.
  • ReadGet metadata on company fieldsReturns metadata on non-list-specific Company Fields.
  • ReadGet metadata on person fieldsReturns metadata on non-list-specific Person Fields.
  • ReadGet metadata on saved viewsReturns metadata on the Saved Views on a List.

Questions

How does LuumenAI connect to Affinity?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in Affinity on its own?

No. Every one of the 20 tools LuumenAI has for Affinity is read-only, so it can answer questions from Affinity but cannot change anything in it. Reads are not gated — they answer immediately, and each one is recorded on the audit trail with the actor and the result.

Who gets access to the integration?

You decide. Access is granted per agent, skill, and team, and per environment — production is not staging.

Is there an audit trail?

Every call to Affinity is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put Affinity to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.