skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

hubspot-create-contact

Create new contacts in HubSpot CRM via API with email and optional profile fields.

Updated Jan 22, 2026
Search Tags:#api#python#sales#crm#hubspot#lead management#create contact
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-create-contact-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hubspot-create-contact
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-create-contact
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-create-contact-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually adding contacts to HubSpot CRM through the web interface is slow and repetitive, especially when onboarding leads in bulk or integrating contact creation into automated workflows. ## Core Features & Use Cases - Programmatic Contact Creation: Create HubSpot contacts with a single command using email as the required identifier. - Optional Profile Fields: Attach firstname, lastname, phone, and company in the same operation. - Pre-Flight Config Validation: Verify HubSpot API credentials and scopes before attempting the write operation. - Use Case: After a webinar, add each registrant to your CRM by running the create contact command with their email, name, and company, then confirm creation from the returned contact ID. ## Quick Start Ask the AI to create a HubSpot contact with email [email protected], first name John, last name Doe, and company Acme Corp.

Frequently Asked Questions about hubspot-create-contact

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

FAQPage Schema
How do I create a contact in HubSpot via API?▼

Run the create_contact.py script with the required --email parameter and optional --firstname, --lastname, --phone, and --company flags. The script returns the new contact ID and properties as JSON.

What HubSpot API scope is needed to create contacts?▼

Creating contacts requires the crm.objects.contacts.write scope on your HubSpot access token. A 403 error indicates this scope is missing and the token must be regenerated with the correct permissions.

Why does HubSpot return a 409 error when creating a contact?▼

A 409 error means a contact already exists with that email address, since HubSpot uses email as a unique identifier. Use the search or update contact operations instead to modify the existing record.

Can I create a HubSpot contact without an email address?▼

No, email is the required parameter for this operation. Optional fields like firstname, lastname, phone, and company can be omitted, but the contact cannot be created without an email value.

What happens when HubSpot API rate limits are hit?▼

The API returns a 429 error when rate limited. The recommended handling is to wait and retry the request rather than immediately resubmitting, which would trigger further throttling.

Related Skills

Explore More Marketing & Sales Skills→
abdullahbeamabdullahbeam
2

hubspot-get-associations

Retrieve associated HubSpot CRM records for contacts, companies, and deals.

Community
Intermediate
djinilabsdjinilabs
8

HubSpot Sales CRM

Manage contacts, companies, and deals via the HubSpot API.

Official
Intermediate
wyre-technologywyre-technology
39

HubSpot Contacts

Manages, searches, and updates contact records in HubSpot CRM.

Official
Intermediate
mailtrapmailtrap
7

managing-contacts

Manage marketing contacts and bulk imports via the Mailtrap Contacts API.

Official
Intermediate