hubspot-update-contact

Update existing HubSpot CRM contact properties by contact ID via Python scripts.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-update-contact-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hubspot-update-contact
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-update-contact
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-update-contact-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually editing contact records in HubSpot CRM is slow and error-prone, especially when you need to update fields like email, phone, or company from a conversation or workflow. This Skill updates an existing HubSpot contact's properties directly through the API using a contact ID. ## Core Features & Use Cases - Field Updates: Modify email, firstname, lastname, phone, and company properties on an existing contact record. - Contact Lookup Support: Search for a contact by name first to retrieve the ID when the user only provides a name. - Structured Output: Returns JSON with the updated contact properties and a formatted confirmation display. - Use Case: A sales rep says "update John Doe's phone number to +1987654321" — the Skill searches for the contact, retrieves the ID, and applies the update in one flow. ## Quick Start Ask the AI to update a HubSpot contact, for example: update contact ID 12345 with the new company name New Corp Inc.

Frequently Asked Questions about hubspot-update-contact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update a contact in HubSpot CRM?

Run the update_contact.py script with the contact ID and at least one property flag such as --email, --phone, --firstname, --lastname, or --company. The script calls the HubSpot API and returns the updated contact as JSON.

How do I find a HubSpot contact ID by name?

Use the search_contacts.py script with the --name parameter, for example --name "John Doe". It returns matching contacts with their IDs, which you then pass to the update script via the --id parameter.

What HubSpot API scope is needed to update contacts?

Updating contacts requires the crm.objects.contacts.write scope on your HubSpot private app token. A 403 error indicates the scope is missing, while a 401 error means the token itself is invalid and setup must be re-run.

Why does HubSpot contact update return a 404 error?

A 404 error means the contact ID does not exist in the CRM. Verify the ID by searching for the contact first, since deleted or incorrect IDs cannot be updated.

Can I update multiple HubSpot contact fields at once?

Yes, pass multiple property flags in a single command, such as --firstname and --company together. At least one optional property is required, and all provided fields are updated in one API call.