09G007 – Register users to a Viral Share Campaign using a Webhook

Once your Viral Share Campaign has been setup, at the bottom of the settings page you will find your Registration Webhook. This is the incoming webhook you can use to register users.

NOTE: You need to pass the email of the contact, using the Registration Webhook URL with the post or get parameter “contactEmail”.


To do this:
  • Go to your emailing system. (e.g. Active Campaign) You can do exact same thing with Infusionsoft, Ontraport or Convertkit. However, they might have different ways of doing it, we suggest to check it with their support.
  • Click the Campaign on the left sidebar menu and select the one that you’re working with.
  • Copy and paste the Registration Webhook URL from the Viral Campaign Settings on the email. Always add an ampersand if you’re going to add a new parameter on the URL and then an equal sign before the value. For example: https://domain/addViralRegistrant.php?vc=2&contactEmail=
  • To get the “contactEmail” value, click the Personalize button.
  • Click the Email address.
  • The complete Registration Webhook URL will look like this based on our example: https://domain/addViralRegistrant.php?vc=2&contactEmail=%EMAIL%
  • Copy the complete Registration Webhook URL and you may now proceed to your Automations on your email system.
  • Click the Automations on the left side bar menu. Select the one that you’re working with.
  • Click the + sign to add new action.
  • Click the Conditions and Workflow on the left side bar menu and select Webhook.
  • Lastly, paste the complete Registration Webhook URL here and click on Save.
  • That is where KLEQ will receive the information of the user and once we received the data, we can register the user to this Viral Share campaign.
  • If you do not want the user to receive the registration email, add &email=no at the end of the webhook URL.

IMPORTANT: There is a limit of 100 requests of registration per minute. This is to protect your site from too many requests. If too many requests are sent, then once the 100 limit cap is reached, any extra requests will be ignored.



Related Articles

Setting up your Viral Share Campaign
Step 02 – How to enable registration for the Viral Share Campaign
Step 03 – Setting up the Viral Share Thank You Page