Create Contact (LeadConnector)
GoHighLevel → Create Contact (LeadConnector)
/v1/gohighlevel-create-contact{ "first_name": "Jane", "last_name": "Doe", "unique_name": "Jane Doe", "email": "[email protected]", "mobile_number": "sample-value", "type": "sample-value", "company_name": "Acme, Inc.", "address_1": "sample-value", "city": "sample-value", "state": "sample-value", "postal_code": "sample-value", "country": "sample-value", "website": "https://acme.com", "timezone": "sample-value", "date_of_birth": "sample-value", "gender": "sample-value", "source": "sample-value", "tag": "sample-value", "dnd": true, "dnd_call_status": "sample-value", "dnd_email_status": "[email protected]", "dnd_sms_status": "sample-value", "dnd_whatsapp_status": "sample-value", "dnd_gmb_status": "sample-value", "dnd_fb_status": "sample-value", "inbound_dnd_all_status": "sample-value" }
{ "ok": true, "data": { "contact_id": "rec_4f3a91", "date_added": "sample", "date_updated": "sample", "deleted": true, "tag": "sample", "type": "sample", "location_id": "rec_4f3a91", "first_name": "sample", "first_name_lower_case": "sample", "full_name_lower_case": "sample", "last_name": "sample", "last_name_lower_case": "sample", "email": "[email protected]", "email_lower_case": "[email protected]", "bounce_email": "[email protected]", "unsubscribe_email": "[email protected]", "valid_email": "[email protected]", "valid_email_date": "[email protected]", "dnd": true, "dnd_date": "sample", "dnd_call_status": "valid", "dnd_call_message": "sample", "dnd_call_code": "sample", "dnd_email_status": "[email protected]", "dnd_email_message": "[email protected]", "dnd_email_code": "[email protected]", "dnd_sms_status": "valid", "dnd_sms_message": "sample", "dnd_sms_code": "sample", "dnd_whatsapp_status": "valid", "dnd_whatsapp_message": "sample", "dnd_whatsapp_code": "sample", "dnd_gmb_status": "valid", "dnd_gmb_message": "sample", "dnd_gmb_code": "sample", "dnd_fb_status": "valid", "dnd_fb_message": "sample", "dnd_fb_code": "sample", "inbound_dnd_all_status": "valid", "inbound_dnd_all_message": "sample", "gender": "sample", "mobile_number": "sample", "address_1": "sample", "city": "sample", "state": "sample", "country": 1, "postal_code": "sample", "website": "https://acme.com", "source": "sample", "company_name": "sample", "date_of_birth": "sample", "birth_month": 1, "birth_day": 1, "last_session_activity_at": "sample", "created_by_source": "sample", "created_by_channel": "sample", "created_by_source_id": "rec_4f3a91", "created_by_timestamp": "sample", "last_updated_by_source": "sample", "last_updated_by_channel": "sample", "last_updated_by_source_id": "rec_4f3a91", "last_updated_by_timestamp": "sample", "offer": "sample", "product": "sample", "business_id": "rec_4f3a91", "assigned_to": "sample", "trace_id": "rec_4f3a91" } }
Creates a new contact record in GoHighLevel CRM with specified details.
Install
Add create contact (leadconnector) to your MCP client.
Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__gohighlevel-create-contact
When to use this.
The "Create Contact (LeadConnector)" action in GoHighLevel CRM enables users to efficiently create new contact records with detailed information. Key input parameters include firstName, lastName, email, phone, and companyName, allowing for comprehensive contact profiles. Optional fields such as address, dateOfBirth, and gender enhance data richness. The action outputs essential data including contact_id, date_added, and DND statuses, ensuring effective contact management. This functionality is ideal for businesses looking to streamline lead generation, customer relationship management, and marketing efforts within the CRM category, making it a vital tool for enhancing customer engagement and data organization.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Create Contact (LeadConnector)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
contact_idContact Idtextdate_addedDate Addednullabletextdate_updatedDate UpdatednullabletextdeletedDeletednullablebooleantagTagnullabletexttypeTypenullabletextlocation_idLocation Idnullabletextfirst_nameFirst Nametextfirst_name_lower_caseFirst Name Lower Casenullabletextfull_name_lower_caseFull Name Lower Casenullabletextlast_nameLast Nametextlast_name_lower_caseLast Name Lower CasenullabletextemailEmailtextemail_lower_caseEmail Lower Casenullabletextbounce_emailBounce Emailnullablebooleanunsubscribe_emailUnsubscribe Emailnullablebooleanvalid_emailValid Emailnullablebooleanvalid_email_dateValid Email DatenullabletextdndDndnullablebooleandnd_dateDnd Datenullabletextdnd_call_statusDnd Call Statusnullabletextdnd_call_messageDnd Call Messagenullabletextdnd_call_codeDnd Call Codenullabletextdnd_email_statusDnd Email Statusnullabletextdnd_email_messageDnd Email Messagenullabletextdnd_email_codeDnd Email Codenullabletextdnd_sms_statusDnd Sms Statusnullabletextdnd_sms_messageDnd Sms Messagenullabletextdnd_sms_codeDnd Sms Codenullabletextdnd_whatsapp_statusDnd Whatsapp Statusnullabletextdnd_whatsapp_messageDnd Whatsapp Messagenullabletextdnd_whatsapp_codeDnd Whatsapp Codenullabletextdnd_gmb_statusDnd Gmb Statusnullabletextdnd_gmb_messageDnd Gmb Messagenullabletextdnd_gmb_codeDnd Gmb Codenullabletextdnd_fb_statusDnd Fb Statusnullabletextdnd_fb_messageDnd Fb Messagenullabletextdnd_fb_codeDnd Fb Codenullabletextinbound_dnd_all_statusInbound Dnd All Statusnullabletextinbound_dnd_all_messageInbound Dnd All MessagenullabletextgenderGendernullabletextmobile_numberMobile Numbertextaddress_1Address 1nullabletextcityCitytextstateStatenullabletextcountryCountrytextpostal_codePostal CodenullabletextwebsiteWebsitenullabletextsourceSourcenullabletextcompany_nameCompany Nametextdate_of_birthDate Of Birthnullabletextbirth_monthBirth Monthnullablenumberbirth_dayBirth Daynullablenumberlast_session_activity_atLast Session Activity Atnullabletextcreated_by_sourceCreated By Sourcenullabletextcreated_by_channelCreated By Channelnullabletextcreated_by_source_idCreated By Source Idnullabletextcreated_by_timestampCreated By Timestampnullabletextlast_updated_by_sourceLast Updated By Sourcenullabletextlast_updated_by_channelLast Updated By Channelnullabletextlast_updated_by_source_idLast Updated By Source Idnullabletextlast_updated_by_timestampLast Updated By TimestampnullabletextofferOffernullabletextproductProductnullabletextbusiness_idBusiness Idnullabletextassigned_toAssigned Tonullabletexttrace_idTrace Idnullabletext
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/gohighlevel-create-contact. Auth: x-api-key.
/v1/gohighlevel-create-contactcurl -X POST 'https://v3-api.texau.com/api/v1/gohighlevel-create-contact' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"first_name":"Jane","last_name":"Doe","unique_name":"Jane Doe","email":"[email protected]","mobile_number":"sample-value","type":"sample-value","company_name":"Acme, Inc.","address_1":"sample-value","city":"sample-value","state":"sample-value","postal_code":"sample-value","country":"sample-value","website":"https://acme.com","timezone":"sample-value","date_of_birth":"sample-value","gender":"sample-value","source":"sample-value","tag":"sample-value","dnd":true,"dnd_call_status":"sample-value","dnd_email_status":"[email protected]","dnd_sms_status":"sample-value","dnd_whatsapp_status":"sample-value","dnd_gmb_status":"sample-value","dnd_fb_status":"sample-value","inbound_dnd_all_status":"sample-value"}'
{ "ok": true, "data": { "contact_id": "rec_4f3a91", "date_added": "sample", "date_updated": "sample", "deleted": true, "tag": "sample", "type": "sample", "location_id": "rec_4f3a91", "first_name": "sample", "first_name_lower_case": "sample", "full_name_lower_case": "sample", "last_name": "sample", "last_name_lower_case": "sample", "email": "[email protected]", "email_lower_case": "[email protected]", "bounce_email": "[email protected]", "unsubscribe_email": "[email protected]", "valid_email": "[email protected]", "valid_email_date": "[email protected]", "dnd": true, "dnd_date": "sample", "dnd_call_status": "valid", "dnd_call_message": "sample", "dnd_call_code": "sample", "dnd_email_status": "[email protected]", "dnd_email_message": "[email protected]", "dnd_email_code": "[email protected]", "dnd_sms_status": "valid", "dnd_sms_message": "sample", "dnd_sms_code": "sample", "dnd_whatsapp_status": "valid", "dnd_whatsapp_message": "sample", "dnd_whatsapp_code": "sample", "dnd_gmb_status": "valid", "dnd_gmb_message": "sample", "dnd_gmb_code": "sample", "dnd_fb_status": "valid", "dnd_fb_message": "sample", "dnd_fb_code": "sample", "inbound_dnd_all_status": "valid", "inbound_dnd_all_message": "sample", "gender": "sample", "mobile_number": "sample", "address_1": "sample", "city": "sample", "state": "sample", "country": 1, "postal_code": "sample", "website": "https://acme.com", "source": "sample", "company_name": "sample", "date_of_birth": "sample", "birth_month": 1, "birth_day": 1, "last_session_activity_at": "sample", "created_by_source": "sample", "created_by_channel": "sample", "created_by_source_id": "rec_4f3a91", "created_by_timestamp": "sample", "last_updated_by_source": "sample", "last_updated_by_channel": "sample", "last_updated_by_source_id": "rec_4f3a91", "last_updated_by_timestamp": "sample", "offer": "sample", "product": "sample", "business_id": "rec_4f3a91", "assigned_to": "sample", "trace_id": "rec_4f3a91" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
crm
Update Opportunity Status (LeadConnector)
Update the status of a specific opportunity in LeadConnector.
Get Business/Company (LeadConnector)
Retrieves the details of a specific standalone Business (Company) record using its ID.
Create Business/Company (LeadConnector)
Creates a new standalone Business (Company) record in GoHighLevel.
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 (leadconnector) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Built for
Who runs this.
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 GoHighLevel actions.
Update Opportunity Status (LeadConnector)
Update the status of a specific opportunity in LeadConnector.
Get Business/Company (LeadConnector)
Retrieves the details of a specific standalone Business (Company) record using its ID.
Create Business/Company (LeadConnector)
Creates a new standalone Business (Company) record in GoHighLevel.
Upsert Opportunity (LeadConnector)
Create a new opportunity or update an existing one using the Upsert endpoint in LeadConnector.
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__gohighlevel-...` 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 (LeadConnector) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.