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

Related Skills

• hubspot-list-contacts – List all contacts
• hubspot-search-contacts – Find existing contacts
• hubspot-update-contact – Update contact details