Webhooks in ClickFunnels

Need to send your customer’s event information to an external source using Webhooks? This article will explain how Webhooks work and how to create a Webhook in ClickFunnels. This is only recommended for those with Webhook experience.

Prior to getting started, you will need to have the following:

• An Existing Funnel
  

• Check to make sure that your URL is hosted by an external source.  URL's hosted by ClickFunnels will not work

• Previous knowledge about webhooks

Webhooks In ClickFunnels

A Webhook is an event-driven communication method between two apps. It allows you to send real-time data from one application to another whenever a given event occurs. For example, it can notify every time a customer opts-in or makes a purchase in your funnel as it is happening.

Step 1: Creating An Endpoint

This is done on your external source, not in ClickFunnels. You will need to have the endpoint set up before you can create a Webhook in ClickFunnels.

1. Creating A Test Endpoint.

First, you will need to create a test endpoint at <your-domain/funnel_webhooks/test>

And it should include the headers below.

• • • Content-Type as application/json
      

    • The payload (HTTP message body) will be a JSON object with a key of "time" and value of the current time in UTC as follows:
      { "time": "YYYY-MM-DD HH:MM:SS UTC" }
      

This is done to verify that your Webhook meets these criteria.

• • • Must be a URL to an external resource not hosted by clickfunnels.com.
      

    • Must return a response within 3 seconds.
      

    • If we receive a response back with a status code less than 400 within the allowable response time we will accept the Webhook URL.
      

2. Creating A Real Endpoint.

This should be an endpoint on your server where you want to capture Webhook Events.

Step 2: Creating A Webhook

This is done in ClickFunnels after you have created your endpoint on your external source.

1. Creating A Test Webhook.

a. Access the Funnels Page by hovering over the ClickFunnels drop-down menu from your dashboard and clicking on Funnels.

b. Choose the funnel you want to edit by clicking on the Funnel Name.

c. Click on the Settings tab.

d. Scroll down to Webhooks and click on the Manage Your Funnel Webhooks button to access the Funnel Webhooks Page.

e. Click on the + New Webhook button.

f. Enter your Webhook URL. This should be the test URL. For example, www.yourdomain.com/funnel_webhooks/test

g. Select the Event(s) you want to trigger your Webhook from the Event drop-down menu.

• • All Events

  • contact_created

  • contact_updated

  • contact_destroyed

  • purchase_created

  • purchase_updated

  • purchase_destroyed

h. Select the Webhook version from the Version drop-down menu. We recommend choosing the default option.

The version is just an internal attribute that you can use to reference which Webhook you’re using.

i. Select the adapter from the Adapter drop-down menu. We recommend choosing the default option.

The adapter refers to how the Webhook will deliver the data or payload to the configured Webhook URL.

j. Click on the Create Funnel Webhook button.

2. Creating A Real Webhook

a. Access the Funnels Page by hovering over the ClickFunnels drop-down menu from your dashboard and clicking on Funnels.

b. Choose the funnel you want to edit by clicking on the Funnel Name.

c. Click on the Settings tab.

d. Scroll down to Webhooks and click on the Manage Your Funnel Webhooks button to access the Funnel Webhooks Page.

e. Click on the + New Webhook button.

f. Enter your Webhook URL. This should be the real URL. For example, www.yourdomain.com/webhook_events

g. Select the Event(s) you want to trigger your Webhook from the Event drop-down menu.

• • • • • All Events

        • contact_created

        • contact_updated

        • contact_destroyed

        • purchase_created

        • purchase_updated

        • purchase_destroyed

h. Select the Webhook version from the Version drop-down menu. We recommend choosing the default option.

The version is just an internal attribute that you can use to reference which Webhook you’re using.

i. Select the adapter from the Adapter drop-down menu. We recommend choosing the default option.

The adapter refers to how the Webhook will deliver the data or payload to the configured Webhook URL.

j. Click on the Create Funnel Webhook button.

Funnel Webhooks Page

When accessing the Funnel Webhooks Page, you will be able to see your Active and Archived Funnel Webhooks. For both Active and Archived Funnel Webhooks, you will see the Webhook information.

• URL - Webhook URL.
  
  

• Events -  The Event(s) the Webhook triggered.

Archiving An Active Webhook

1. Click the Archive button.

2. Click OK to confirm. 

Restoring An Actived Webhook

1. Click the Restore button.

2. Click OK to confirm. 

Funnel Webhook Deliveries Page

If you want to see whether your Webhook was delivered or not, you can click on the Deliveries button.

Here, you will be able to see the delivery information.

• Created - When was the Webhook sent.
  

• Payload - The information that was sent via the Webhook.
  

• Attempts - How many times it took for the Webhook to be delivered.
  

• Success? - If the Webhook was delivered or not.
  
  

Trouble Shooting Steps

Important Note: If you are having trouble with your webhooks within your funnel, we recommend trying these troubleshooting steps with a Webhook Tester

1. Go to Request Catcher's website: https://requestcatcher.com
2. Enter a test subdomain.  See image below:
3. Click the green Get Started button
4. Copy the URL that is generated
   
5. Go to your funnel settings in ClickFunnels and scroll down to the Webhooks section
6. Click manage webhooks
7. Next click Create New Webhook
8. Enter the webhook details as depicted below.  Note: you will need to replace the test subdomain with the subdomain you are using to test
9. After entering the details the final step is to click the blue button that says Create Funnel Webhook
10. Next, you will need to go to your funnel and optin in as a test
    
11. Next, navigate back to your funnel settings and scroll to the bottom and select Manage Your Funnel Webhooks
    
12. Next to the Archive button you will see a clickable link that will show you your successful deliveries.  
    
13. Click on the blue Deliveries (1)
    
14. Check to make sure your attempt was a success. 
15. After performing these steps and receiving a successful attempt you have validated that webhooks should work with your desired funnel
    
    

 If you have any questions about this, please contact our support team by clicking the support icon in the bottom right-hand corner of this page.