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