Webform GoHighLevel Integration

Introduction

Webform GoHighLevel Integration sends Drupal Webform submissions straight into GoHighLevel. Every enquiry creates or updates a contact, gets tagged, and can drop into the pipeline and stage you choose as a new opportunity. No Zapier, no middleman, no copy and paste.

Built and maintained by a UK agency that runs it on live trades websites every day.

Features

• GoHighLevel API v2 using a Private Integration Token.
• No duplicate contacts. Repeat enquiries update the existing contact, matched on email or phone.
• Opportunities. Pick the pipeline and stage from a dropdown pulled live from your GoHighLevel account. Set a name pattern and an optional value field, such as a budget dropdown.
• Address handling. Map a single Webform address field and it is split into street, town/city, county, postcode and country automatically. Or map separate fields for each part.
• Field mapping for first name, last name, full name, email, phone, company and website.
• Tags. A fixed tag on every submission, a tag taken straight from a field, and mapped tags that translate form answers into your own tag names. Existing tags on the contact are kept.
• Lead source taken from a field such as "Where did you find us", with a default fallback.
• Conversation message. Post the enquiry text into the contact's conversation thread.
• Contact type: Lead or Customer.
• Sent once when a submission is completed. Drafts are never sent.

Requirements

• Drupal 10.1, 11 or 12.
• Webform.
• A GoHighLevel sub-account.

Getting your Private Integration Token

1. Log in to the GoHighLevel sub-account your leads should go to.
2. Go to Settings > Private Integrations and click Create new Integration.
3. Give it a name, for example "Website forms".
4. Tick these scopes:
   • contacts.readonly
   • contacts.write
   • opportunities.readonly
   • opportunities.write
   • conversations/message.write
5. Create it and copy the token. GoHighLevel only shows it once.

Your Location ID is the code after /location/ in your GoHighLevel web address.

Setup

1. Install and enable the module.
2. Open your webform and go to Settings > Emails / Handlers.
3. Click Add handler and choose GoHighLevel Handler.
4. Enter your token and Location ID, map your fields and save.
5. To create opportunities, edit the handler again, tick Create an opportunity, choose your pipeline and stage, and save.

Submit a test enquiry and check Reports > Recent log messages, filtered by webform_gohighlevel, to see exactly what was sent.

Upgrading from 1.0.x

Update the module and clear caches. Your existing handler settings carry over. If you want opportunities, add the two opportunity scopes to your Private Integration Token.