Introduction
In this article you’ll discover how to send leads to Go High Level using Webhook Node.
Special thanks to Rob Olsen who has provided much of the content shared on page.
Please see the accompanying detailed notes below as well…
PLEASE NOTE: You no longer have to use the custom script to format phone numbers. LeadsHook now has a simple filters to convert your phone number into the correct format.
Video Instructions:
Download Sample Decision Tree:
REQUIRED
- LeadsHook Account
- GoHighLevel Account
- Access Website.hook (or similar service for testing)
PHONE DATA FORMAT
GoHighLevel accepts phone number formats with specific formatting…
GoHighLevel accepts phone numbers in the following formats…
International code: +12223334444
Inside LeadsHook, simple add the following filter…
{your_phone_number_field|e164}
E.164 is the format by which most SMS and phone systems accepts phone numbers.
In your webhook node, it will look like this…
Understanding GoHighLevel’s API and Custom Field Requirements
STEP 1: Get GoHighLevel API Key
1. Make sure to select the proper subaccount/account.
2. Click Business Profile
3. Click the copy button to copy the API key for the selected Subaccount
Add the API key on your API/webhook node within Leadshook
NOTE: API Key format is Bearer(space){APIKEY}
STEP 2: LeadsHook Webhook Node
The sample json provided is structured as follows…
Pre-created Standard Fields: Fields that exist in EVERY GoHighLevel Account.
Tags: You can manually add your tags here in an array format or dynamically add your tags in an array format using {_lead_tags_array}.
"tags": {_lead_tags_array},User Created Fields: Fields you create for your specific campaigns created from the custom fields user interface. These fields are added as an array under customField as shown above. Please ensure you use custom field ids.
Please watch the VIDEO above to learn how to find your custom field ids
How to Create Custom Fields within your subaccount/account.
1. Make sure to select the sub account/account where you want to create the custom field.
2. Click “Settings”
3. Click Business Profile to grab your API key.
4. Click “Copy” to copy your API key if you still haven’t got it.
5. Click “Custom Fields” to go to the Custom field creation page.
6. Click “Add Field”
7. Select the format of the field you are about to create, make sure to select the appropriate type for the incoming data from Leadshook.
8. Enter the field name.
9. Click “Save”
Please update your webhook with LeadsHook custom fields. Remove any fields you are not using. Please use the fields ribbon to reduce typing errors – click field in the ribbon to add to field into your webhook.
Step 3: Test Webhook to Webhook.site (Optional)
Before sending webhook to GoHighLevel, send a test webhook to Webhook.site so you can examine the webhook call and its content. This allows you to ensure all field values are transferred as expected. This is much easier to catch errors.
TIP! Build your GoHighLevel Webhook and then CLONE the node.
And then replace the Webhook URL as shown below. Remove this test node before sending live traffic.
Step 4: Test Webhook to GoHighLevel
Publish and Test Lead Transfer
References:
Go High Level API Docs: https://public-api.gohighlevel.com/
UPDATE: As of of Aug 2, 2023, GHL had a recent update for A2P Compliance.
Some of your old working GHL connections might be affected.
They have now set the Country as required to know if your lead is from United States or Canada.
If you do not specify a Country then GHL will reject the lead.
More info here: https://help.gohighlevel.com/support/solutions/articles/48001238163-what-is-a2p-10dlc-
In order to fix this, you can either set a static Country Value on your webhook payload as shown below.
Or adjust your form and ask for the address and map it to The address fields on your Webhook payload.
