Upsert Contact (LeadConnector)
GoHighLevel → Upsert Contact (LeadConnector)
/v1/gohighlevel-upsert-contact{ "first_name": "Jane", "last_name": "Doe", "unique_name": "Jane Doe", "email": "[email protected]", "mobile_number": "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", "source": "sample-value", "date_of_birth": "sample-value", "gender": "sample-value", "tag": "sample-value", "dnd": true, "create_new_if_duplicate_allowed": 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": { "is_new": true, "success": true, "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]", "additional_email": "[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", "additional_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", "offer": "sample", "product": "sample", "business_id": "rec_4f3a91", "follower": "sample", "trace_id": "rec_4f3a91" } }
Creates a new contact or updates an existing one based on the Location's duplicate contact settings (Email/Phone).
Install
Add upsert 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-upsert-contact
When to use this.
The "gohighlevel-upsert-contact" action facilitates the creation or updating of a contact within the LeadConnector CRM, intelligently managing duplicates based on predefined settings for email and phone. Key input parameters include optional fields such as firstName, lastName, email, phone, and companyName, allowing for comprehensive contact profiles. The action returns essential output data, including contact_id, is_new status, and various DND (Do Not Disturb) flags, ensuring effective communication management. This action is particularly useful for businesses looking to maintain accurate and up-to-date contact records, streamline lead management, and enhance customer relationship strategies within the CRM category.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Upsert Contact (LeadConnector)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
is_newIs NewbooleansuccessSuccessnullablebooleancontact_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 Casenullabletextadditional_emailAdditional Emailnullabletextbounce_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 Numbertextadditional_mobile_numberAdditional Mobile Numbernullabletextaddress_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 TimestampnullabletextofferOffernullabletextproductProductnullabletextbusiness_idBusiness IdnullabletextfollowerFollowernullabletexttrace_idTrace Idnullabletext
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/gohighlevel-upsert-contact. Auth: x-api-key.
/v1/gohighlevel-upsert-contactcurl -X POST 'https://v3-api.texau.com/api/v1/gohighlevel-upsert-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","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","source":"sample-value","date_of_birth":"sample-value","gender":"sample-value","tag":"sample-value","dnd":true,"create_new_if_duplicate_allowed":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": { "is_new": true, "success": true, "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]", "additional_email": "[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", "additional_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", "offer": "sample", "product": "sample", "business_id": "rec_4f3a91", "follower": "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 → upsert 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 limit60 / min
- Per-day limit10,000 / day
- 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 Upsert Contact (LeadConnector) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.