Upsert Contact (LeadConnector)
Creates a new contact or updates an existing one based on the Location's duplicate contact settings (Email/Phone).
GoHighLevelWhat it needs.
Map each field to a column in your table. Optional fields can stay empty.
first_nameThe first name of the contact.nullabletextlast_nameThe last name of the contact.nullabletextunique_nameThe full name of the contact.nullabletextemailThe email address of the contact.nullabletextmobile_numberThe phone number of the contact.nullabletextcompany_nameThe company name associated with the contact.nullabletextaddress_1The street address.nullabletextcityThe city.nullabletextstateThe state or province.nullabletextpostal_codeThe postal code or zip code.nullabletextcountryThe country code (e.g., US).nullabletextwebsiteThe contact's website URL.nullabletexttimezoneSelect the contact's timezone.nullableselectsourceSource of the contact.nullabletextdate_of_birthDate of birth (e.g., 1990-09-25).nullabletextgenderGender of the contact.nullabletexttagA single tag for the contact.nullabletextdndGlobal Do Not Disturb flag.nullablebooleancreate_new_if_duplicate_allowedIf true, creates a new contact even if a duplicate exists (respects Location settings).nullablebooleandnd_call_statusSelect Active or Inactive.nullableselectdnd_email_statusSelect Active or Inactive.nullableselectdnd_sms_statusSelect Active or Inactive.nullableselectdnd_whatsapp_statusSelect Active or Inactive.nullableselectdnd_gmb_statusSelect Active or Inactive.nullableselectdnd_fb_statusSelect Active or Inactive.nullableselectinbound_dnd_all_statusSelect Active or Inactive.nullableselect
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.
What it returns.
Every field this action writes back to the row. Click a line 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
How this fits a workflow.
Trigger → Upsert Contact (LeadConnector) → enrich → push to your CRM. You set it up once; after that it runs without you.
- Step 1TriggerNew row, form submit, or schedule.
- Step 2Upsert Contact (LeadConnector)The GoHighLevel action runs.
- Step 3EnrichWaterfall fills missing fields.
- Step 4Push to CRMHubSpot / Pipedrive / Zoho CRM / GoHighLevel.
Two actions you can chain after this one:
Throughput & reliability.
How fast it drains a table, and what happens when the upstream provider has a bad day.
- Per-minute limit60 / min
- Per-day limit10,000 / day
- RetriesAutomatic w/ backoff
- Failed lookupsZero credits
More GoHighLevel actions.
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.
Upsert Opportunity (LeadConnector)
Create a new opportunity or update an existing one using the Upsert endpoint in LeadConnector.
FAQ.
Run Upsert Contact (LeadConnector) in 60 seconds.
Connect the account, drop the action on a column, run it on your rows.