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 "+1987654321"
--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": "john@example.com", "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