name: hubspot-create-note description: "Create a note engagement in HubSpot CRM. Load when user says 'create note', 'add note', 'new note', 'record note'. Requires body content."
Create HubSpot Note
Specialized skill for creating note 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
--body- Note content (required)
Optional Parameters
--timestamp- ISO timestamp (defaults to now)
Examples
Simple note:
python 00-system/skills/hubspot/hubspot-master/scripts/create_note.py \
--body "Spoke with John about pricing. He's interested in the enterprise tier." \
--json
Note with timestamp:
python 00-system/skills/hubspot/hubspot-master/scripts/create_note.py \
--body "Meeting notes from yesterday's call" \
--timestamp "2025-12-12T14:00:00Z" \
--json
Output Format
{
"id": "16977760701",
"properties": {
"hs_note_body": "Spoke with John about pricing...",
"hs_timestamp": "2025-12-13T10:00:00Z"
}
}
Display Format
✅ Note created!
ID: 16977760701
Content: Spoke with John about pricing. He's interested in the enterprise tier.
Timestamp: 2025-12-13 10:00
Best Practices
- Keep notes concise but informative
- Include action items and next steps
- Reference specific topics discussed
- Use for internal context that won't go in emails
Error Handling
| Error | Solution |
|---|---|
| 401 | Invalid token - re-run setup |
| 403 | Missing crm.objects.notes.write scope |
| 429 | Rate limited - wait and retry |
Related Skills
hubspot-list-notes- List all noteshubspot-get-associations- Link note to contact/deal