In this article, we will cover how to set up postbacks (webhooks) for your affiliate links so that you can run automation off sales when someone signs up using your affiliate link.

NOTE: 

This Article is for the HighLevel Affiliate Program, NOT Affiliate Manager Feature found in your sub-accounts.

Update
You can now opt-in to receive email notifications for referral activity in the portal.

To do so...
- Click your profile name in the top-right of the Affiliate Dashboard.
- Open Notification Settings.
- Turn notifications on and customize


By default, these notifications may be turned off, so it's worth checking this setting.

Turning notifications on is highly recommended. It’s the easiest way to stay informed without needing to check your portal every time something changes.

Step-by-step guide on setting up affiliate program postbacks (webhooks).

You'll need a few things to get started:

• Download The Core Postback Snapshot - this provides the templates for you to follow this tutorial step-by-step in order to set up postbacks.
• Open your Affiliate Dashboard

1. Initial Setup & Navigation

• Open your agency account
• Go to a sub-account specific for affiliates or one that is dedicated and will not trigger other campaigns or flows.
• Click on the Affiliate Portal tab.
• Click on Promoter Reports
• Scroll down to Postbacks and click it

  
  

2. Workflows

For each Postback, you will need a corresponding Workflow that starts with an Inbound Webhook trigger.

That means for every workflow, you'll need to...

1. Create the postback
2. Send a test postback
3. Fetch the sample request inside the workflow
4. Save the mapping reference
5. Save and publish the workflow

Without a sample payload, the workflow trigger will not save correctly.

The 5 Core Postbacks

Following along with the table above, you will set up five postbacks to correspond with the five workflows included in The Core Postback Snapshot

1. Lead Subscribed
2. New Referral (Trial Started)
3. First Payment Customer
4. New Commission
5. Cancelled Customer

Step 1: Lead Subscribed Postback
 
This triggers when someone completes the first step of the affiliate signup form but has not started a trial yet.
 
Create the Postback
 
Inside Postbacks:
Click Create Postback
Name: 1 - Lead Subscribed
Campaign: HighLevel Affiliate Program
Trigger: Lead Subscribed
 
Connect the Workflow
 
Open the corresponding workflow
Copy the Webhook URL
Paste it into the Postback URL field
 
Send Test Data
 
Click Test Postback
Go back to the workflow trigger
Click Fetch Sample Request
Save the mapping reference
Save the trigger
Save the workflow
 
 
Step 2: Trial Signup / New Referral
 
This triggers when someone starts a trial.
 
Create the Postback
 
Name: 2 - Trial Signup
Campaign: HighLevel Affiliate Program
Trigger: New Referral
 
Connect the Workflow
 
Paste the second workflow webhook URL into the Postback URL field.
 
Finish Setup
 
Click Test Postback
Fetch the sample request
Save the mapping reference
Save the workflow
 
 
Step 3: First Payment Customer
 
This triggers the first time a user becomes a paying customer.
 
This can happen when:
 
A trial user makes an in-app payment
A trial converts into a paid customer
 
 
Important: This trigger only fires once per customer.
 
 
Create the Postback
 
Name: 3 - First Payment Customer
Campaign: HighLevel Affiliate Program
Trigger: New Customer
 
Connect the Workflow
 
Paste the webhook URL from the third workflow.
 
Finish Setup
 
Click Test Postback
Fetch the sample request
Save the mapping reference
Save the workflow
 
 
Step 4: New Commission
 
This triggers every time a commission is generated.
 
Unlike the previous trigger, this can happen multiple times for the same customer.
 
Create the Postback
 
Name: 4 - New Commission
Campaign: HighLevel Affiliate Program
Trigger: New Commission
 
Connect the Workflow
 
Paste the webhook URL from the fourth workflow.
 
Finish Setup
 
Click Test Postback
Fetch the sample request
Save the mapping reference
Save the workflow
 
 
Tip: If you do not want contacts repeatedly re-entering workflows every time a commission occurs, disable workflow re-entry or use tagging logic instead.
 
 
 
Step 5: Cancelled Customer
 
This triggers when a customer account is cancelled.
 
Important
 
The cancellation postback fires when the account actually closes, not when the cancellation request is submitted.
 
Examples:
 
Trial users remain active until the trial ends
Paid users remain active until the billing cycle finishes
 
Create the Postback
 
Name: 5 - Cancelled Customer
Campaign: HighLevel Affiliate Program
Trigger: Lead Cancelled
 
Connect the Workflow
 
Paste the webhook URL from the fifth workflow.
 
Finish Setup
 
Click Test Postback
Fetch the sample request
Save the mapping reference
Save the workflow
 
 
Publish Your Workflows
 
After all five workflows are configured:
 
Open each workflow
Click Publish
Click Save
 
If workflows are not published, postbacks will not trigger.

Adding a SubID

Understanding and Setting Up Sub IDs

Sub IDs are crucial for tracking the origin of your leads, sources, or trials. They help you pinpoint exactly where your traffic is coming from.

Recommendation: Since creating a unique link for every piece of content is tedious, it is recommended to create one Sub ID to use for the entire platform (e.g., Instagram) to track its overall performance.

Email Notification Settings

You can enable automated email notifications from FirstPromoter. These emails help you track new leads and payments directly through your inbox.