List Lists
affinity_list_listsRetrieve all lists from Affinity CRM, including details like ID, name, and type (company, person, or opportunity). Use list IDs to fetch entries.
Instructions
Get all lists in Affinity CRM.
Lists are spreadsheet-like collections containing companies, persons, or opportunities. Each list has custom fields for tracking deals, contacts, etc.
Returns (JSON): { "data": [ { "id": number, // List ID (use for affinity_get_list_entries) "name": string, // List display name "type": string, // "company", "person", or "opportunity" "creatorId": number, // User who created the list "ownerId": number, // User who owns the list "isPublic": boolean // Whether visible to all users } ], "count": number, // Items in response "hasMore": boolean, // More results available "nextCursor": string|null, // Pagination cursor "summary": string // Human-readable summary }
Note: To get list fields/columns, use GET /v2/lists/{listId}/fields (not yet implemented). To get list entries (rows), use affinity_get_list_entries with the list ID.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of lists 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" |