hubspot-log-call

name	hubspot-log-call
description	Log a call engagement in HubSpot CRM. Load when user says 'log call', 'record call', 'add call', 'call made'. Requires title, optional body and duration.

Log HubSpot Call

Specialized skill for logging call 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

• --title - Call title (required)

Optional Parameters

• --body - Call notes/summary
• --duration - Duration in minutes (default: 0)
• --direction - OUTBOUND or INBOUND (default: OUTBOUND)
• --status - COMPLETED, BUSY, NO_ANSWER, etc. (default: COMPLETED)

Examples

Log completed call:

python 00-system/skills/hubspot/hubspot-master/scripts/log_call.py \
  --title "Discovery Call with Acme" \
  --body "Discussed requirements, timeline, and budget. Next step: send proposal." \
  --duration 30 \
  --json

Log missed call:

python 00-system/skills/hubspot/hubspot-master/scripts/log_call.py \
  --title "Follow-up attempt" \
  --status "NO_ANSWER" \
  --direction "OUTBOUND" \
  --json

---

Call Status Values

Status	Meaning
COMPLETED	Call connected
BUSY	Line busy
NO_ANSWER	No answer
FAILED	Call failed
CANCELED	Call canceled

---

Output Format

{
  "id": "14772074448",
  "properties": {
    "hs_call_title": "Discovery Call with Acme",
    "hs_call_body": "Discussed requirements...",
    "hs_call_direction": "OUTBOUND",
    "hs_call_duration": "1800000",
    "hs_call_status": "COMPLETED",
    "hs_timestamp": "2025-12-13T10:00:00Z"
  }
}

---

Display Format

✅ Call logged!
  ID: 14772074448
  Title: Discovery Call with Acme
  Direction: Outbound
  Duration: 30 minutes
  Status: Completed
  Notes: Discussed requirements, timeline...

---

Error Handling

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

---

Related Skills

• hubspot-list-calls - List all calls
• hubspot-get-associations - Link call to contact