Create Contact (HubSpot)
HubSpot → Create Contact (HubSpot)
POST/v1/hubspot-create-contact
texau__hubspot-create-contactcrmcURL · api.texau.app
84ms
POST
/v1/hubspot-create-contact{ "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "job_title": "sample-value", "mobile_number": "sample-value", "life_cycle_stage": "sample-value", "lead_status": "sample-value", "content_membership_note": "sample-value", "message": "sample-value", "content_membership_status": "sample-value", "annual_revenue": 1, "chat_assistant_iql_date": "sample-value", "chat_assistant_source": "sample-value", "chat_assistant_summary": "sample-value", "city": "sample-value", "company": "Acme, Inc.", "country": "sample-value", "country_region_code": "sample-value", "role": "sample-value", "seniority": "sample-value", "sub_role": "sample-value", "fax": "sample-value", "industry": "sample-value", "content_membership_email": "[email protected]", "number_of_employee": "sample-value", "zip": "sample-value", "salutation": "sample-value", "language": "sample-value", "state": "sample-value", "state_code": "sample-value", "address": "sample-value", "timezone": "sample-value", "twitter_handle": "sample-value", "website": "https://acme.com", "whatsapp_mobile_number": "sample-value", "facebook_click_id": "sample-value", "google_click_id": "sample-value", "linkedin_click_id": "https://www.linkedin.com/in/jane-doe", "buying_role": "sample-value", "close_date": "sample-value", "email_quarantine_reason": "[email protected]", "email_type": "[email protected]", "company_size": "Acme, Inc.", "date_of_birth": "sample-value", "degree": "sample-value", "field_of_study": "sample-value", "gender": "sample-value", "graduation_date": "sample-value", "job_function": "sample-value", "marital_status": "sample-value", "military_status": "sample-value", "relationship_status": "sample-value", "school": "sample-value", "start_date": "sample-value", "work_email": "[email protected]", "linkedin_url": "https://acme.com", "latest_source": "sample-value", "analytics_source": "sample-value" }
200 Accepted
{ "ok": true, "data": { "id": "rec_4f3a91", "created_at": "sample", "updated_at": "sample", "archived": true, "url": "https://acme.com", "address": "sample", "annual_revenue": "sample", "city": "sample", "close_date": "sample", "company": "sample", "country": 1, "create_date": "sample", "date_of_birth": "sample", "day_to_close": "sample", "degree": "sample", "email": "[email protected]", "fax": "sample", "field_of_study": "sample", "first_name": "sample", "gender": "sample", "graduation_date": "sample", "all_contact_vid": "rec_4f3a91", "associated_target_account": 1, "buying_role": "sample", "country_region_code": 1, "currently_enrolled_in_prospecting_agent": true, "email_domain": "[email protected]", "facebook_click_id": "rec_4f3a91", "full_name_or_email": "[email protected]", "google_click_id": "rec_4f3a91", "is_contact": true, "is_unworked": true, "language": "sample", "lead_status": "valid", "lifecyclestage_lead_date": "sample", "linkedin_click_id": "rec_4f3a91", "linkedin_url": "https://acme.com", "membership_has_accessed_private_content": "sample", "object_id": "rec_4f3a91", "object_source": "sample", "object_source_id": "rec_4f3a91", "object_source_label": "sample", "persona": "sample", "pipeline": "sample", "prospecting_agent_actively_enrolled_count": 1, "prospecting_agent_total_enrolled_count": 1, "registered_member": "sample", "searchable_calculated_mobile_number": "sample", "sequences_actively_enrolled_count": 1, "state_code": "sample", "timezone": "sample", "v2_date_entered_current_stage": "sample", "v2_time_in_current_stage": "sample", "industry": "sample", "job_function": "sample", "job_title": "sample", "last_modified_date": "sample", "last_name": "sample", "life_cycle_stage": "sample", "marital_status": "valid", "military_status": "valid", "mobile_number": "sample", "num_note": "sample", "number_of_employee": "sample", "relationship_status": "valid", "salutation": "sample", "school": "sample", "seniority": "sample", "start_date": "sample", "state": "sample", "twitter_handle": "sample", "website": "https://acme.com", "zip": "sample" } }
Creates a new contact in HubSpot with email, name, phone, and custom properties.
Install
Add create contact (hubspot) to your MCP client.
Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.
claude_desktop_config.json
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__hubspot-create-contact
When to use this.
The "Create Contact (HubSpot)" action allows users to efficiently create new contacts within HubSpot's CRM system. This action requires essential input parameters such as email, first name, and last name, while also supporting optional fields like job title, mobile number, and company name to capture comprehensive contact details. Upon successful execution, the action outputs critical data including the contact's unique ID, creation date, and various attributes like annual revenue, industry, and lifecycle stage. This functionality is particularly useful for businesses looking to streamline their lead management processes, enhance customer relationship management, and maintain organized contact records. Ideal for CRM integration and marketing automation, this action falls under the CRM category, making it a vital tool for sales and marketing teams aiming to improve engagement and conversion rates.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Create Contact (HubSpot)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
FieldType
idIdtextcreated_atCreated Atnullabletextupdated_atUpdated AtnullabletextarchivedArchivednullablebooleanurlUrlnullabletextaddressAddressnullabletextannual_revenueAnnual RevenuenullabletextcityCitynullabletextclose_dateClose DatenullabletextcompanyCompanytextcountryCountrynullabletextcreate_dateCreate Datenullabletextdate_of_birthDate Of Birthnullabletextday_to_closeDay To ClosenullabletextdegreeDegreenullabletextemailEmailtextfaxFaxnullabletextfield_of_studyField Of Studynullabletextfirst_nameFirst NametextgenderGendernullabletextgraduation_dateGraduation Datenullabletextall_contact_vidAll Contact Vidnullabletextassociated_target_accountAssociated Target Accountnullabletextbuying_roleBuying Rolenullabletextcountry_region_codeCountry Region Codenullabletextcurrently_enrolled_in_prospecting_agentCurrently Enrolled In Prospecting Agentnullablebooleanemail_domainEmail Domainnullabletextfacebook_click_idFacebook Click Idnullabletextfull_name_or_emailFull Name Or Emailnullabletextgoogle_click_idGoogle Click Idnullabletextis_contactIs Contactnullablebooleanis_unworkedIs UnworkednullablebooleanlanguageLanguagenullabletextlead_statusLead Statusnullabletextlifecyclestage_lead_dateLifecyclestage Lead Datenullabletextlinkedin_click_idLinkedin Click Idnullabletextlinkedin_urlLinkedin Urltextmembership_has_accessed_private_contentMembership Has Accessed Private Contentnullabletextobject_idObject Idnullabletextobject_sourceObject Sourcenullabletextobject_source_idObject Source Idnullabletextobject_source_labelObject Source LabelnullabletextpersonaPersonanullabletextpipelinePipelinenullabletextprospecting_agent_actively_enrolled_countProspecting Agent Actively Enrolled Countnullabletextprospecting_agent_total_enrolled_countProspecting Agent Total Enrolled Countnullabletextregistered_memberRegistered Membernullabletextsearchable_calculated_mobile_numberSearchable Calculated Mobile Numbernullabletextsequences_actively_enrolled_countSequences Actively Enrolled Countnullabletextstate_codeState CodenullabletexttimezoneTimezonenullabletextv2_date_entered_current_stageV2 Date Entered Current Stagenullabletextv2_time_in_current_stageV2 Time In Current StagenullabletextindustryIndustrynullabletextjob_functionJob Functionnullabletextjob_titleJob Titletextlast_modified_dateLast Modified Datenullabletextlast_nameLast Nametextlife_cycle_stageLife Cycle Stagenullabletextmarital_statusMarital Statusnullabletextmilitary_statusMilitary Statusnullabletextmobile_numberMobile Numbertextnum_noteNum Notenullabletextnumber_of_employeeNumber Of Employeenullabletextrelationship_statusRelationship StatusnullabletextsalutationSalutationnullabletextschoolSchoolnullabletextsenioritySenioritynullabletextstart_dateStart DatenullabletextstateStatenullabletexttwitter_handleTwitter HandlenullabletextwebsiteWebsitenullabletextzipZipnullabletext
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/hubspot-create-contact. Auth: x-api-key.
cURL · api.texau.app
84ms
POST
/v1/hubspot-create-contactcurl -X POST 'https://v3-api.texau.com/api/v1/hubspot-create-contact' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"email":"[email protected]","first_name":"Jane","last_name":"Doe","job_title":"sample-value","mobile_number":"sample-value","life_cycle_stage":"sample-value","lead_status":"sample-value","content_membership_note":"sample-value","message":"sample-value","content_membership_status":"sample-value","annual_revenue":1,"chat_assistant_iql_date":"sample-value","chat_assistant_source":"sample-value","chat_assistant_summary":"sample-value","city":"sample-value","company":"Acme, Inc.","country":"sample-value","country_region_code":"sample-value","role":"sample-value","seniority":"sample-value","sub_role":"sample-value","fax":"sample-value","industry":"sample-value","content_membership_email":"[email protected]","number_of_employee":"sample-value","zip":"sample-value","salutation":"sample-value","language":"sample-value","state":"sample-value","state_code":"sample-value","address":"sample-value","timezone":"sample-value","twitter_handle":"sample-value","website":"https://acme.com","whatsapp_mobile_number":"sample-value","facebook_click_id":"sample-value","google_click_id":"sample-value","linkedin_click_id":"https://www.linkedin.com/in/jane-doe","buying_role":"sample-value","close_date":"sample-value","email_quarantine_reason":"[email protected]","email_type":"[email protected]","company_size":"Acme, Inc.","date_of_birth":"sample-value","degree":"sample-value","field_of_study":"sample-value","gender":"sample-value","graduation_date":"sample-value","job_function":"sample-value","marital_status":"sample-value","military_status":"sample-value","relationship_status":"sample-value","school":"sample-value","start_date":"sample-value","work_email":"[email protected]","linkedin_url":"https://acme.com","latest_source":"sample-value","analytics_source":"sample-value"}'
200 Accepted
{ "ok": true, "data": { "id": "rec_4f3a91", "created_at": "sample", "updated_at": "sample", "archived": true, "url": "https://acme.com", "address": "sample", "annual_revenue": "sample", "city": "sample", "close_date": "sample", "company": "sample", "country": 1, "create_date": "sample", "date_of_birth": "sample", "day_to_close": "sample", "degree": "sample", "email": "[email protected]", "fax": "sample", "field_of_study": "sample", "first_name": "sample", "gender": "sample", "graduation_date": "sample", "all_contact_vid": "rec_4f3a91", "associated_target_account": 1, "buying_role": "sample", "country_region_code": 1, "currently_enrolled_in_prospecting_agent": true, "email_domain": "[email protected]", "facebook_click_id": "rec_4f3a91", "full_name_or_email": "[email protected]", "google_click_id": "rec_4f3a91", "is_contact": true, "is_unworked": true, "language": "sample", "lead_status": "valid", "lifecyclestage_lead_date": "sample", "linkedin_click_id": "rec_4f3a91", "linkedin_url": "https://acme.com", "membership_has_accessed_private_content": "sample", "object_id": "rec_4f3a91", "object_source": "sample", "object_source_id": "rec_4f3a91", "object_source_label": "sample", "persona": "sample", "pipeline": "sample", "prospecting_agent_actively_enrolled_count": 1, "prospecting_agent_total_enrolled_count": 1, "registered_member": "sample", "searchable_calculated_mobile_number": "sample", "sequences_actively_enrolled_count": 1, "state_code": "sample", "timezone": "sample", "v2_date_entered_current_stage": "sample", "v2_time_in_current_stage": "sample", "industry": "sample", "job_function": "sample", "job_title": "sample", "last_modified_date": "sample", "last_name": "sample", "life_cycle_stage": "sample", "marital_status": "valid", "military_status": "valid", "mobile_number": "sample", "num_note": "sample", "number_of_employee": "sample", "relationship_status": "valid", "salutation": "sample", "school": "sample", "seniority": "sample", "start_date": "sample", "state": "sample", "twitter_handle": "sample", "website": "https://acme.com", "zip": "sample" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
Create Contact (HubSpot)→List Contacts (HubSpot)→Get Contact (HubSpot)
crm
List Contacts (HubSpot)
Retrieves all HubSpot contacts with email, name, phone, company, and custom properties.
Get Contact (HubSpot)
Retrieves a specific HubSpot contact by ID with all standard, demographic, and custom properties.
Create Company (HubSpot)
Creates a new company record in HubSpot with firmographic properties and optional associations.
Output
Results land in a TexAu table.
Sample rows below.
Real result preview coming soon.
| Input | Status | Score |
|---|---|---|
| [email protected] | valid | 96 |
| [email protected] | risky | 54 |
| [email protected] | invalid | 12 |
Workflow
A real example.
Trigger → create contact (hubspot) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Step 1TriggerNew row, webhook, or schedule.
Step 2Create Contact (HubSpot)HubSpot action runs.
Step 3EnrichWaterfall fills missing fields.
Step 4Push to CRMHubSpot / Salesforce / Pipedrive.
Built for
Who runs this.
GTM EngineerRevOpsAgency
Reliability
Rate limits & reliability.
- Per-minute limitNo public cap
- Per-day limitPlan-defined
- RetriesAutomatic w/ backoff
- ModeSync
Errors
HTTP status codes.
What each response means and what to do about it.
| Code | Cause | Fix |
|---|---|---|
| 200 OK | Action ran. Data in `data`. | Read response. |
| 400 Bad Request | Missing or malformed input. | Validate against the input schema. |
| 401 Unauthorized | Missing or invalid `x-api-key`. | Re-issue from /api-platform. |
| 403 Forbidden | Workspace lacks plan tier. | Upgrade or contact sales. |
| 404 Not Found | Action key not recognized. | Verify the slug. |
| 429 Rate Limited | Per-minute or per-day cap hit. | Backoff; reduce concurrency. |
| 500 Server Error | Unexpected TexAu issue. | Retry with backoff. |
| 502 Bad Gateway | Upstream provider 5xx. | Retry; we surface root cause. |
| 504 Timeout | Upstream slower than maxLatency. | Switch to `isAsync` polling. |
Related
More HubSpot actions.
List Contacts (HubSpot)
Retrieves all HubSpot contacts with email, name, phone, company, and custom properties.
Get Contact (HubSpot)
Retrieves a specific HubSpot contact by ID with all standard, demographic, and custom properties.
Create Company (HubSpot)
Creates a new company record in HubSpot with firmographic properties and optional associations.
Search Contacts (HubSpot)
Search for HubSpot CRM contacts by email address or other filters and retrieve their properties.
FAQ.
Is this real-time?
Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).
Do I get charged on failure?
No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.
Does it work with Claude / Cursor via MCP?
Yes. Add the texau MCP server to your client config, then call `texau__hubspot-...` directly.
What CRMs can I push results to?
HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.
Run Create Contact (HubSpot) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.