In this article, we will cover:
Overview
Tapfiliate can be seamlessly integrated with GoHighLevel (GHL) to enable affiliate click tracking, conversion attribution, coupon/referral-code attribution, and customer-lifetime tracking. By combining page-level Tapfiliate JavaScript with GoHighLevel’s Webhook automation actions, you can create a powerful, automated affiliate tracking system without requiring a native integration.
Pros:
No plugins needed
Fast setup
Clean attribution using referral/coupon codes
Works for funnels, websites, forms, and checkout pages
API-based conversion tracking is extremely reliable
Cons:
Requires adding code to page headers
Requires setting up custom fields
Does not automatically track SKU or product-level commissions
Incorrect webhook setup can prevent conversions from firing
GohighLevel integration Prerequisites
To successfully integrate, ensure you have the following:
A live Tapfiliate account with your Account ID and API Key
A GoHighLevel account with:
Access to Funnels / Websites → Custom Code
Access to Workflows
Access to custom Webhook actions
A referral code or coupon code created inside Tapfiliate and assigned to an affiliate
A custom field in GHL to collect that referral code (e.g., Referral Code)
Setting up the GoHighLevel integration
You will configure:
Click tracking (page-level)
Conversion tracking (workflow-level via webhook)
Step 1: Set Up Click Tracking (Required)
Add the Tapfiliate tracking script to your GHL site. In GoHighLevel, navigate to:
Sites → Funnels → Settings → Custom Code → Head and paste this code:
<script src="https://script.tapfiliate.com/tapfiliate.js" type="text/javascript" async></script>
<script type="text/javascript">
(function(t,a,p){t.TapfiliateObject=a;t[a]=t[a]||function(){
(t[a].q=t[a].q||[]).push(arguments)}})(window,'tap');
tap('create', 'YOUR-ACCOUNT-ID', { integration: "custom" });
tap('detect');
</script>
Replace YOUR-ACCOUNT-ID with your Tapfiliate Account ID.
This script tracks clicks from affiliate links and stores the visitor’s affiliate information.
Step 2: Set Up Conversion Tracking
Conversions will be attributed using referral or coupon codes entered by the customer.
Create a Referral Code Field in GHL
Go to:
Settings → Custom Fields → Create Field → Input Field
Use:
Label: Referral Code
Field Name: referral_code
Add this field to your checkout form, booking form, order form or enrollment form wherever payment or signup happens, or as per your use case.
Step 3: Add the Conversion Webhook in GoHighLevel
Inside GHL:
Go to Automations → Workflows
Click Create Workflow
Add a trigger such as:
Form Submitted
Order Submitted
Tag Applied (“Purchased”)
Click + Add Action
Choose custom webhook
Webhook URL
Headers
Content-Type: application/json
x-api-Key: YOUR_API_KEY
Replace YOUR_API_KEY with your Tapfiliate API key.
JSON Body (Referral-Code Based Conversion)
{"customer_id": "{{contact.id}}","external_id": "{{contact.email}}","amount": "{{opportunity.amount}}","referral_code": "{{contact.referral_code}}"}
Explanation:
{{contact.referral_code}} is the code your customer enters
Tapfiliate matches this to the correct affiliate
This is the cleanest and most reliable integration method for GHL.
Advanced or Optional Features
1. Add Metadata to Conversions: You can send contact details or purchase info:
{
"customer_id": "{{contact.id}}",
"external_id": "{{contact.email}}",
"revenue": "{{opportunity.amount}}",
"coupons": "{{contact.referral_code}}",
"meta_data": {
"name": "{{contact.name}}",
"phone": "{{contact.phone}}"
}
}
Metadata appears inside Tapfiliate under the conversion record.
2. Refund or Cancellation Tracking: You can directly disapprove a commission for the conversion when a refund takes place:
Webhook URL:
HTTP Request: DELETE
Testing and Verification
Follow these steps to ensure tracking is set up correctly:
1. Create a Test Affiliate in Tapfiliate: Generate a referral link + referral code.
2. Click the referral link: Confirm the click appears inside Tapfiliate.
3. Submit your GHL form: Enter the referral code you created.
4. Trigger a purchase: Ensure the Workflow webhook fires.
5. Verify the conversion: Check your Tapfiliate dashboard → Conversions. It should show the correct affiliate, the revenue amount and any metadata sent.
Still need help?
If you have any questions or if something in this guide is unclear, please contact us at: 📩 support@tapfiliate.com. We’re happy to assist!