hubspot-create-contact
Create a new contact in HubSpot CRM. Load when user says 'create contact', 'add contact', 'new contact'. Requires email, optional firstname, lastname, phone, company.
When & Why to Use This Skill
This Claude skill enables seamless integration with HubSpot CRM to automate the creation of new contacts using natural language commands. By streamlining the lead entry process, it allows users to instantly sync essential information—including email, names, phone numbers, and company details—directly into their CRM, significantly reducing manual data entry and improving sales pipeline efficiency.
Use Cases
- Instant Lead Capture: Quickly add new prospects to your HubSpot database during or after a meeting by simply telling Claude to 'add a new contact' with their details.
- Sales Productivity Boost: Reduce the administrative burden on sales teams by using voice or text commands to populate CRM records instead of navigating complex web interfaces.
- Data Consistency: Ensure all new contacts are created with standardized fields (email, phone, company) through a guided AI interaction, minimizing human error in CRM management.
- Seamless Outreach Integration: Use this skill as a starting point for sales sequences by immediately registering new leads discovered during research or outreach sessions.
| name | hubspot-create-contact |
|---|---|
| description | "Create a new contact in HubSpot CRM. Load when user says 'create contact', 'add contact', 'new contact'. Requires email, optional firstname, lastname, phone, company." |
Create HubSpot Contact
Specialized skill for creating 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
--email- Contact email address (required)
Optional Parameters
--firstname- First name--lastname- Last name--phone- Phone number--company- Company name
Examples
Minimal (email only):
python 00-system/skills/hubspot/hubspot-master/scripts/create_contact.py \
--email "john@example.com" \
--json
Full contact:
python 00-system/skills/hubspot/hubspot-master/scripts/create_contact.py \
--email "john@example.com" \
--firstname "John" \
--lastname "Doe" \
--phone "+1234567890" \
--company "Acme Corp" \
--json
Output Format
{
"id": "12345",
"properties": {
"email": "john@example.com",
"firstname": "John",
"lastname": "Doe",
"createdate": "2025-12-13T10:00:00Z"
}
}
Display Format
✅ Contact created!
ID: 12345
Name: John Doe
Email: john@example.com
Phone: +1234567890
Company: Acme Corp
Error Handling
| Error | Solution |
|---|---|
| 401 | Invalid token - re-run setup |
| 403 | Missing crm.objects.contacts.write scope |
| 409 | Contact already exists with this email |
| 429 | Rate limited - wait and retry |
Related Skills
hubspot-list-contacts- List all contactshubspot-search-contacts- Find existing contactshubspot-update-contact- Update contact details