List Persons
affinity_list_personsList persons from Affinity CRM with optional enriched, custom, or relationship-intelligence fields. Retrieve by specific IDs or paginate through all contacts.
Instructions
List persons (contacts) from Affinity CRM.
Returns person records with optional field data. Without fieldTypes parameter, returns only basic info (id, firstName, lastName, primaryEmailAddress, emailAddresses, type).
Field Types:
enriched: Data from Affinity Data (8 fields: job title, organization, location, phone, LinkedIn, etc.)
global: Your account's custom person fields
relationship-intelligence: Email/calendar derived data (9 fields: first/last email, events, etc.)
Important Notes:
This endpoint does NOT support text/name filtering
To find specific persons: use the 'ids' parameter with known person IDs
To search/filter persons: use Saved Views via affinity_get_list_entries
Returns max 100 persons per request; use cursor for pagination
type="internal" means person is in your organization
Returns (JSON): { "data": [ { "id": number, // Person ID "firstName": string, // First name "lastName": string, // Last name "primaryEmailAddress": string, // Main email "emailAddresses": string[], // All emails "type": string, // "internal" or "external" "fields": [...] // Field data (if requested) } ], "count": number, // Items in response "hasMore": boolean, // More results available "nextCursor": string|null, // Pagination cursor "summary": string // Human-readable summary }
Enriched fields (8):
affinity-data-current-job-title, affinity-data-current-organization
affinity-data-job-titles, affinity-data-industry
affinity-data-location, affinity-data-phone-number
affinity-data-linkedin-url, companies (Organizations)
Relationship Intelligence fields (9):
first-email, last-email, last-contact
first-event, last-event, next-event
first-chat-message, last-chat-message
source-of-introduction
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Filter by specific person IDs. Example: [66880587, 142768223] | |
| fieldTypes | No | Field categories to include. Options: "enriched" (Affinity Data), "global" (custom fields), "relationship-intelligence" (email/calendar data). Without this, no field data is returned. | |
| fieldIds | No | Specific field IDs to return. Example: ["affinity-data-current-job-title", "last-email"] | |
| limit | No | Number of persons to return per page. Default: 100, Max: 100 | |
| cursor | No | Pagination cursor from previous response (pagination.nextPageToken) | |
| responseFormat | No | Output format: "json" for structured data or "markdown" for human-readable. Default: "json" |