Custom Webhook Setup in GoHighLevel

A custom webhook in GoHighLevel (GHL) allows you to automate tasks by sending data to external services, enabling seamless integration with other platforms. This guide provides a step-by-step process for setting up a custom webhook, including configuring headers, API keys, and tag UUIDs.

The configuration is specifically for catching leads from different lead sources.

This article contains the following sections:

1. Create a Custom Webhook
2. Configuring the Webhook
3. Generate and Add API Key
4. Generate and Add Tag UUID
5. Save and Test Your Webhook

Let's get started!

Create a Custom Webhook

• Navigate to GHL and select the option to create a 'Custom Webhook' from the search bar.

• Choose the Premium Action version for the webhook setup.

Configuring the Webhook

• Fill out the fields with the needed information.
  • Action Name
  • Event

  • Method

    

• URL: The link comes from Campaign Refinery's public API site.
• Copy the URL below and paste it into the URL field.

• https://app.campaignrefinery.com/rest/contacts/subscribe

  

• You can also set:

• Authorization
  • Value: None
• Headers: Add the necessary headers as shown in the configuration. You can copy the ones below:
  • Key: accept; Value: application/json
  • Key: content-type; Value: application/json
• Query Parameters (Skip by default)
• Content-Type
  • Value: application/json
• Raw Body

• By default, the Raw Body should look like the image below:

  

• To successfully integrate with the Campaign Refinery system, you must copy and paste the values ​​below into your Raw Body:

{
  "key": "PASTE YOUR API CODE HERE",
  "first_name": "{{contact.first_name}}",
  "last_name": "{{contact.last_name}}",
  "email": "{{contact.email}}",
  "phone": "{{contact.phone}}",
  "tags": "PASTE YOUR UUID CODE HERE"
}

• After pasting, your Raw Body should look like this:

  

• After configuring your Raw Body, you must add your API Key and UUID code.

Generate and Add API Key

• Go to your Campaign Refinery API section accountand generate a new API Key if one does not already exist.

  

• Go to the Webhook configuration and insert the First Name, Last Name, Email, Phone Number, and Tags.

  

• Now, your Raw Body should look like this:

  

Generate and Add Tag UUID

• Navigate to Contacts > Tags > Select the desired tag (e.g., 1Test Facebook) and copy its UUID.

  

• Paste the UUID into the webhook configuration.

• Now, your Raw Body should look like this:

  

Save and Test Your Webhook

• After saving the webhook configuration, create a new contact within GoHighLevel to test the workflow.

  

• Add your name, last name and your email address, then click on 'Save' and verify that the contact is created.

  

• Go back to your webhook configuration and click 'Test Workflow', select the contact that you created and click on 'Run Test'.

  

• Now in Campaign Refinery, under the logo, click the search bar, add the email address that you created and hit 'Enter'.

• Or go to to Contacts > All Contacts > Enter the email address in the search bar and hit 'Enter' to see if your test account appears.

  

Now your webhook is working. Congratulations!