abdullahbeam/hubspot-log-email

Log HubSpot Email

Specialized skill for logging email engagements in 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

Required Parameters

• --subject - Email subject line (required)
• --body - Email body content (required)

Optional Parameters

• --direction - EMAIL (sent) or INCOMING_EMAIL (received)
• --timestamp - ISO timestamp (defaults to now)

Examples

Log sent email:

python 00-system/skills/hubspot/hubspot-master/scripts/log_email.py \
  --subject "Follow up on proposal" \
  --body "Hi John, following up on our conversation about the enterprise package..." \
  --json

Log received email:

python 00-system/skills/hubspot/hubspot-master/scripts/log_email.py \
  --subject "Re: Proposal" \
  --body "Thanks for sending over the details..." \
  --direction "INCOMING_EMAIL" \
  --json

---

Output Format

{
  "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"
  }
}

---

Display Format

✅ Email logged!
  ID: 14389550562
  Subject: Follow up on proposal
  Direction: Sent
  Status: SENT
  Timestamp: 2025-12-13 10:00

---

Error Handling

| Error | Solution | |-------|----------| | 401 | Invalid token - re-run setup | | 403 | Missing crm.objects.emails.write scope | | 429 | Rate limited - wait and retry |

---

Related Skills

• hubspot-list-emails - List all emails
• hubspot-get-associations - Link email to contact