List email engagements from HubSpot CRM. Load when user says 'list emails', 'show emails', 'email history', 'hubspot emails'. Returns logged email records.
Specialized skill for listing email engagements 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_emails.py --json
python 00-system/skills/hubspot/hubspot-master/scripts/list_emails.py --limit 25 --json
python 00-system/skills/hubspot/hubspot-master/scripts/list_emails.py --after "cursor_value" --json
{
"results": [
{
"id": "14389550562",
"properties": {
"hs_email_subject": "Follow up on proposal",
"hs_email_text": "Hi John, following up on...",
"hs_email_direction": "EMAIL",
"hs_email_status": "SENT",
"hs_timestamp": "2025-12-13T10:00:00Z"
}
}
],
"paging": {
"next": {
"after": "cursor_for_next_page"
}
}
}
Found {count} emails:
1. Follow up on proposal
Direction: Sent
Status: SENT
Date: 2025-12-13 10:00
Preview: Hi John, following up on...
ID: 14389550562
2. Re: Demo request
Direction: Received
...
| Value | Meaning |
|---|---|
| Outbound (sent) | |
| INCOMING_EMAIL | Inbound (received) |
| FORWARDED_EMAIL | Forwarded |
| Error | Solution |
|---|---|
| 401 | Invalid token - re-run setup |
| 403 | Missing crm.objects.emails.read scope |
| 429 | Rate limited - wait and retry |
hubspot-log-email - Log new emailhubspot-get-associations - Get email's linked contacts