abdullahbeam/hubspot-create-note

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 notes
• hubspot-get-associations - Link note to contact/deal