hubspot-update-contact

name	hubspot-update-contact
description	Update an existing contact in HubSpot CRM. Load when user says 'update contact', 'edit contact', 'modify contact', 'change contact'. Requires contact ID.

Update HubSpot Contact

Specialized skill for updating contacts 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

• --id - Contact ID (required)

Optional Parameters (at least one required)

• --email - New email address
• --firstname - New first name
• --lastname - New last name
• --phone - New phone number
• --company - New company name

Examples

Update phone:

python 00-system/skills/hubspot/hubspot-master/scripts/update_contact.py \
  --id 12345 \
  --phone "[phone]" \
  --json

Update multiple fields:

python 00-system/skills/hubspot/hubspot-master/scripts/update_contact.py \
  --id 12345 \
  --firstname "Jonathan" \
  --company "New Corp Inc" \
  --json

---

Finding Contact ID

If user says "update John Doe", first search for the contact:

python 00-system/skills/hubspot/hubspot-master/scripts/search_contacts.py --name "John Doe" --json

Then use the returned ID for the update.

---

Output Format

{
  "id": "12345",
  "properties": {
    "email": "[e-mail]",
    "firstname": "Jonathan",
    "lastname": "Doe",
    "lastmodifieddate": "2025-12-13T10:30:00Z"
  }
}

---

Display Format

✅ Contact updated!
  ID: 12345
  Updated fields:
    - firstname: Jonathan
    - company: New Corp Inc

---

Error Handling

Error	Solution
401	Invalid token - re-run setup
403	Missing crm.objects.contacts.write scope
404	Contact not found - check ID
429	Rate limited - wait and retry

---

Related Skills

• hubspot-search-contacts - Find contact ID
• hubspot-list-contacts - List all contacts
• hubspot-create-contact - Create new contact