Creating a Custom Tool with a GHL Webhook

Introduction

This guide shows you how to create a custom tool that sends extracted data to a GoHighLevel inbound webhook. The goal is to collect multiple pieces of information from a conversation and sync them into contact fields using a single tool.

1. Create the Custom Tool

• Go to Tools & Abilities → Manage Tools.
• Click Create Tool → choose Custom Tool.
• Name it using lowercase and underscores (e.g., qualifying_question_answers).
• Use this description:
  “Always use this tool to extract and store the user's challenges in their sales process, volume of sales calls or customer interactions, and interest in automating their sales process. This is for internal reference only.”

2. Set Up Your Webhook in GoHighLevel

• Open a new GoHighLevel tab and create a new Workflow.
• Set the trigger to Inbound Webhook.
• Copy the Webhook URL and paste it into the Endpoint URL field in your custom tool.
• Keep this workflow tab open—you'll need it to map incoming data.

3. Define Parameters to Extract

Inside the custom tool setup, define what data to send:

• challenges – The user's challenges in their sales process.
• volume – The user's sales call or customer interaction volume.
• interest – Their interest in automating sales processes.

4. Add Tool to Assistant & Prompt It

• After saving the tool, click Add to Assistant.
• Add a prompt line immediately after the qualifying questions (e.g., step 14):

“Call the tool qualifying_question_answers in order to extract the user's response to the qualifying questions in step 14 so a team member can reference them later. This is an internal tool. Do not include tool output in your response. Go to step 16 after using the tool.”

5. Send Mapping Reference

• Save your assistant and start a test conversation with the bot.
• Answer the qualifying questions naturally.
• The tool will trigger and send data to the webhook → which creates a mapping reference in your open workflow tab.

6. Finish Workflow Setup

• Go to your workflow and click the new Mapping Reference.
• Delete the auto-added Create Contact step.
• Add a Find Contact action.
• Use the contact_id from the webhook as the identifier.
• Then, use Update Contact to fill custom fields using the parameters:
• arguments.challenges
• arguments.volume
• arguments.interest
• Save and publish your workflow.

Tips

• Keep your webhook tab open until the bot sends a mapping reference.
• Use descriptive labels in your assistant prompt to trigger the tool reliably.
• Use this method when extracting multiple values at once from one section of the conversation.

Summary

This guide walks you through building a custom tool that sends multiple qualifying question responses to a GoHighLevel workflow via webhook. Once received, the data is stored into contact fields for your team to use later.

• Create a custom tool with a webhook endpoint and define multiple fields.
• Connect the tool to a GoHighLevel workflow via Inbound Webhook.
• Test the bot and allow the mapping reference to be created.
• Use the workflow to find the contact and update their fields.
• Add the tool to your assistant and call it in the prompt after key questions.