Update HubSpot Contact Skill

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

Agent Skills: Update HubSpot Contact

Install this agent skill to your local

Skill Files