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

Related Skills

• hubspot-list-notes – List all notes
• hubspot-get-associations – Link note to contact/deal