abdullahbeam/hubspot-update-contact

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": "[email protected]",
    "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