# Affinity AI integration on Definable

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

## What this connects

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

Vendor: https://www.affinity.co/

## Tools available

**20** tools available. First 12:

- `AFFINITY_GET_A_COMPANY_S_LIST_ENTRIES` — Get a company s list entries — Summarize company data across all lists, including list-specific fields and metadata like creation date and author. Access requires "Export data from Lists" permission.
- `AFFINITY_GET_A_COMPANY_S_LISTS` — Get a company s lists — Returns metadata for all the Lists on which the given Company appears.
- `AFFINITY_GET_ALL_COMPANIES` — Get all companies — Affinity API allows paginated access to company info and custom fields. Use `fieldIds` or `fieldTypes` to specify data in a request. Retrieve field IDs/Types via GET `/v2/companies/fields`. Export permission needed.
- `AFFINITY_GET_ALL_LIST_ENTRIES_ON_A_LIST` — Get all list entries on a list — Access and export essential data and metadata for Companies, Persons, or Opportunities from a List, specifying data via `fieldIds` or `fieldTypes`. "Export data from Lists" permission is necessary.
- `AFFINITY_GET_ALL_LIST_ENTRIES_ON_A_SAVED_VIEW` — Get all list entries on a saved view — Use the endpoint to access rows in a Saved View with specific filters and selected fields from a web app. It doesn't maintain sort order, supports only sheet-type views, and requires export permissions.
- `AFFINITY_GET_ALL_OPPORTUNITIES` — Get all opportunities — Pagination through Opportunities in Affinity yields basic info but excludes field data. For field data, use specified GET endpoints. "Export data from Lists" permission needed.
- `AFFINITY_GET_ALL_PERSONS` — Get all persons — The Affinity API offers paginated access to Person data using `fieldIds` or `fieldTypes`. Bulk extraction needs special permissions and supports multiple parameters.
- `AFFINITY_GET_A_PERSON_S_LIST_ENTRIES` — Get a person s list entries — Summary: Browse rows for a Person in all Lists, showing field data and entry metadata like creation time and author. Requires "Export data from Lists" permission.
- `AFFINITY_GET_A_PERSON_S_LISTS` — Get a person s lists — Returns metadata for all the Lists on which the given Person appears.
- `AFFINITY_GET_A_SINGLE_COMPANY` — Get a single company — Retrieve basic company info and specific field data by using `fieldIds` or `fieldTypes` parameters. Multiple fields can be queried. No field data if parameters aren't specified. Requires "Export All Organizations directory" permission.
- `AFFINITY_GET_A_SINGLE_OPPORTUNITY` — Get a single opportunity — Get basic details about an Opportunity without field data via provided endpoints. Field data requires using specific list entry APIs and the "Export data from Lists" permission.
- `AFFINITY_GET_A_SINGLE_PERSON` — Get a single person — Use GET `/v2/persons/fields` with `fieldIds` or `fieldTypes` for detailed data; basic info by default. Request multiple fields at once. "Export All People" permission needed.

## Auth

Auth schemes: `API_KEY`.

## How agents use Affinity

Inside a Definable workflow, Affinity is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Affinity** — the Researcher (GPT-5.5) pulls context from Affinity (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Affinity** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Affinity (create record, post message, draft email).
- **Designer / Engineer → Distributor → Affinity** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Affinity (attach file, open PR comment, post status).

The Verifier checks every Affinity call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- crm — https://definable.ai/apps/category/crm/

## Related

- HTML page: https://definable.ai/apps/affinity/
- Same category (crm): https://definable.ai/apps/category/crm/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt
