List HubSpot Contacts
Specialized skill for listing contacts from HubSpot CRM.
Pre-Flight Check
Before running, execute config check:
python 00-system/skills/hubspot/hubspot-master/scripts/check_hubspot_config.py --json
If ai_action is not proceed_with_operation , follow hubspot-connect setup guide.
Usage
Basic List (default 10 contacts)
python 00-system/skills/hubspot/hubspot-master/scripts/list_contacts.py --json
With Limit
python 00-system/skills/hubspot/hubspot-master/scripts/list_contacts.py --limit 25 --json
With Pagination (after cursor)
python 00-system/skills/hubspot/hubspot-master/scripts/list_contacts.py --after "cursor_value" --json
Output Format
{ "results": [ { "id": "12345", "properties": { "email": "john@example.com", "firstname": "John", "lastname": "Doe", "phone": "+1234567890", "company": "Acme Corp" }, "url": "https://app.hubspot.com/contacts/.../record/0-1/12345" } ], "paging": { "next": { "after": "cursor_for_next_page" } } }
Display Format
Present results to user as:
Found {count} contacts:
-
John Doe Email: john@example.com Phone: +1234567890 Company: Acme Corp ID: 12345
-
Jane Smith Email: jane@example.com ...
Error Handling
Error Solution
401 Invalid token - re-run setup
403 Missing crm.objects.contacts.read scope
429 Rate limited - wait and retry
Related Skills
-
hubspot-create-contact
-
Create new contact
-
hubspot-search-contacts
-
Search by email/name
-
hubspot-update-contact
-
Update existing contact