In this article, we will cover how to set up 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. As an affiliate, you can enroll in any HighLevel Plan. If you want to track your referrals for HighLevel Starter Plan ($97/month) or HighLevel Agency Unlimited ($297/month) using webhooks, please contact the support team. Request to set up your "HighLevel General Affiliate Campaign" webhooks, as shown in the video below. If you want to track your referrals for HighLevel Agency Pro ($497/month) with webhooks, request to set up your "Supercharged SaaS Program" webhooks, which are the same as the ones shown in the video below. Please follow the general process outlined below. Also, inform the support team if you want the webhooks you submitted to apply to referrals for the Supercharged SaaS Program ($497/month).
Mentioned Documentation:
How to use the Inbound Webhook Workflow Premium Trigger?
How to enable and rebill LC Premium Triggers & Actions for Workflows
You can sign up for Postman for free by clicking on this link:
Once you have setup and tested all 5 steps, add the corresponding Webhooks for each, then copy and paste this into a seperate doc to be shared with support (See example below).
Example of what to send to support:
I would like webhooks activated for my affiliate link: [Insert Affiliate Link]
Step 1: lead_subscribed on – [Insert inbound Webhook URL]
Step 2: lead_signup on – [Insert inbound Webhook URL]
Step 3: lead_becomes_referral on – [Insert inbound Webhook URL]
Step 4: reward_created on – [Insert inbound Webhook URL]
Step 5: lead_cancelled on – [Insert inbound Webhook URL]
___
Webhook Sample Used in Postman:
{
"event": {
"id": null,
"type": "",
"created_at": ""
},
"data": {
"id": null,
"state": "",
"email": "",
"uid": null,
"customer_since": null,
"cancelled_at": null,
"plan_name": null,
"suspicion": "",
"username": null,
"website": null,
"created_at": "",
"split_promotion_id": null,
"custom_fields": {
"name": "",
"company_name": "",
"phone_number": ""
},
"split_percentage_value": null,
"promotion": {
"id": null,
"status": "",
"ref_id": "",
"promo_code": null,
"customer_promo_code": null,
"target_reached_at": null,
"promoter_id": null,
"campaign_id": null,
"referral_link": "",
"current_offer": null,
"current_referral_reward": null,
"current_promotion_reward": null,
"current_target_reward": null,
"campaign_name": "HighLevel Affiliate Program",
"hidden": false,
"visitors_count": null,
"leads_count": null,
"customers_count": null,
"refunds_count": null,
"cancellations_count": null,
"sales_count": null,
"sales_total": null,
"refunds_total": null,
"active_customers_count": null
},
"promoter": {
"id": null,
"cust_id": "",
"email": "",
"created_at": "",
"temp_password": "",
"default_promotion_id": null,
"pref": "",
"default_ref_id": "",
"note": null,
"w8_form_url": null,
"w9_form_url": null,
"parent_promoter_id": null,
"earnings_balance": {
"cash": null
},
"current_balance": {
"cash": null
},
"paid_balance": null,
"auth_token": "",
"profile": {
"id": null,
"first_name": "",
"last_name": "",
"website": "",
"company_name": "",
"phone_number": "",
"address": "",
"vat_id": "",
"country": "US",
"paypal_email": "",
"avatar_url": "",
"description": null,
"social_accounts": {
"twitter": {
"url": ""
},
"youtube": {
"url": ""
},
"facebook": {
"url": ""
},
"linkedin": {
"url": ""
},
"instagram": {
"url": ""
}
}
},
"promotions": [
{
"id": null,
"status": "offer_inactive",
"ref_id": "",
"promo_code": null,
"customer_promo_code": null,
"target_reached_at": null,
"promoter_id": null,
"campaign_id": null,
"referral_link": "",
"current_offer": null,
"current_referral_reward": null,
"current_promotion_reward": null,
"current_target_reward": null,
"campaign_name": "HighLevel Affiliate Program",
"hidden": false,
"visitors_count": null,
"leads_count": null,
"customers_count": null,
"refunds_count": null,
"cancellations_count": null,
"sales_count": null,
"sales_total": null,
"refunds_total": null,
"active_customers_count": null
},
{
"id": null,
"status": "offer_inactive",
"ref_id": "",
"promo_code": null,
"customer_promo_code": null,
"target_reached_at": null,
"promoter_id": null,
"campaign_id": null,
"referral_link": "",
"current_offer": null,
"current_referral_reward": null,
"current_promotion_reward": null,
"current_target_reward": null,
"campaign_name": "Supercharged SaaS Program",
"hidden": false,
"visitors_count": 0,
"leads_count": 0,
"customers_count": 0,
"refunds_count": 0,
"cancellations_count": 0,
"sales_count": 0,
"sales_total": 0,
"refunds_total": 0,
"active_customers_count": 0
}
]
}
}}Step-by-step guide on setting up affiliate program webhooks.
The Webhooks that we have on FirstPromoter are as follows:
- Lead Subscribed - Step one of the two-step sign-up form (if you want to nurture leads that have not signed up for a trial)
- Lead Signup - Step two of the two-step Sign up form (Nurture leads that started a trial)
- Lead Converted to Customer (they made their first payment)
- Reward Generated (Anytime they make a qualifying payment)
- Lead Canceled (lead or customer has no more active subscriptions on their account)
1. Head into your Sub-account > Click on the Automation tab > Create New Workflow
Proceed to create your first Workflow: "Step 1: lead_subscribed on."
This will be the webhook that fires whenever someone fills out Step one of the two-step sign-up form (if you want to nurture leads that have not signed up for a trial)
2. Create an inbound webhook trigger > Copy the inbound webhook URL string
3. Open up Postman and follow the steps below:
- Use HTTP Request Method
- Select "Post"
- Paste the webhook URL (The one you copied from the workflow in the step above)
- Select "Body" then "Raw" & select "JSON" as the text file
- Copy the First Promoter Sample data given above into the Body (should be blue)
- Hit "Send"
- Please ensure that you receive a successful response, or kindly begin from the beginning.
4. Return to your Workflow and hit the "fetch sample" button within the trigger.
Grab and select the sample, then proceed to map out the action fields:
5. Map out the fields using the data from the inbound webhook
- Full name
- Phone
6. Repeat this process four more times for the remaining webhooks
- Clone workflow
- Open and grab the webhook
- Head back into Postman
- Paste Code in Postman, and on the doc, you will be sent to support
- Hit "send" in Postman
- After success request, jump back into your workflow
- Hit "fetch samples" and select the new data
- Repeat until you have completed all 5 webhooks
7. Open a new live chat with Highlevel Support and copy and paste the steps or scripts below.
I would like webhooks activated for my affiliate link: [Insert Affiliate Link]
My New Lead webhook is:
Step 1: lead_subscribed on – [Insert inbound Webhook URL]
Step 2: lead_signup on – [Insert inbound Webhook URL]
Step 3: lead_becomes_referral on – [Insert inbound Webhook URL]
Step 4: reward_created on – [Insert inbound Webhook URL]
Step 5: lead_cancelled on – [Insert inbound Webhook URL]
Note:
For the Pro 497 Plan. Webhooks can only be made for
- Lead Converted to Customer (they made their first payment)
- Reward Generated (Anytime they make a qualifying payment)
- Lead Canceled (lead or customer has no more active subscriptions on their account) -
For Lead sign-up and Lead Subscribed, you only need to create one webhook to catch all HighLevel Plans.