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 contacts

• hubspot-search-contacts

• Find existing contacts

• hubspot-update-contact

• Update contact details