hubspot-create-contact

在HubSpot CRM中创建新联系人。当用户说“创建联系人”、“添加联系人”、“新联系人”时加载。需要电子邮件,可选名、姓、电话、公司。

📖 中文导读:在HubSpot CRM中创建新联系人。当用户说“创建联系人”、“添加联系人”、“新联系人”时加载。需要电子邮件,可选名、姓、电话、公司。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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

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