List contacts from HubSpot CRM. Load when user says 'list contacts', 'show contacts', 'get contacts', 'hubspot contacts'. Returns paginated contact list with email, name, phone, company.
Specialized skill for listing contacts from HubSpot CRM.
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.
python 00-system/skills/hubspot/hubspot-master/scripts/list_contacts.py --json
python 00-system/skills/hubspot/hubspot-master/scripts/list_contacts.py --limit 25 --json
python 00-system/skills/hubspot/hubspot-master/scripts/list_contacts.py --after "cursor_value" --json
{
"results": [
{
"id": "12345",
"properties": {
"email": "[email protected]",
"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"
}
}
}
Present results to user as:
Found {count} contacts:
1. John Doe
Email: [email protected]
Phone: +1234567890
Company: Acme Corp
ID: 12345
2. Jane Smith
Email: [email protected]
...
| Error | Solution |
|---|---|
| 401 | Invalid token - re-run setup |
| 403 | Missing crm.objects.contacts.read scope |
| 429 | Rate limited - wait and retry |
hubspot-create-contact - Create new contacthubspot-search-contacts - Search by email/namehubspot-update-contact - Update existing contact