Welcome to the Instapage Support Center

|

Integrating with Webhooks (page level)

webhooks.png

What’s a WebHook?

WebHook is a push notification from our server to yours. The Form Submit WebHook lets you set up a push notification to your server every time someone submits a form on one of your Instapage pages.

What can you do with a WebHook?

WebHooks make it easier to integrate two systems. The most common use for our Form Submit WebHook is to feed leads into your CRM. 

What do you need?

Some CRMs will offer something called "an endpoint URL" which you can use to integrate with as shown in the GIF below, which requires no technical knowledge and is very easy to set up. 

Configure the Webhook

1. Go to the Instapage builder and click on Settings then select Integrations from the drop-down menu;

settings_button.png

IntegrationsSymbol.jpg

2. Select Webhooks from the top menu;

fomo3.jpg

3. Enter your Webhook endpoint URL;

2018-08-22_16h19_50.png

4. Enter your server's token authorization key if you have one;

2018-08-22_17h02_40.png

5. Select the sending method and click Continue;

2018-08-22_17h05_18.png

6. Now you will need to map your Instapage form fields to your Webhooks fields;

2018-08-22_17h09_25.png

7. You can also capture more information about your visitors and send it to your list. Just make sure to match your fields accordingly.

2018-08-22_17h12_23.png

You can track and send the following data from your funnel:

  • Page
  • Variation
  • Desktop/Mobile
  • Timestamp
  • IP Address
  • Referral Source
  • Ad Campaign (Available for Enterprise accounts only)
  • Average Cost per Visitor (Available for Enterprise accounts only)
If you want to test the WebHook integration, you can use a PostBin URL (from www.postbin.org) as a place to temporarily send your form data and examine the data format.
8. That's it!
2018-08-22_17h16_57.png

 

If you want to integrate using Webhooks with your own custom server instead of an online lead management system you will have to write code to accept your form data.

Every time someone makes a new form submission on your page, Instapage will send the following data to your selected URL.

Parameter Description
ip Ip of visitor.
page_id The identifier Instapage uses to uniquely identify your page. Eventually you’ll be able to use this with our API to manipulate and get information about your page.
page_name The name you gave your page, for example “My Guaranteed to Convert Landing Page”.
page_url The URL of the page that contains your form.
variant This identifies the page variant that the visitor saw when they visited your page, and will be a lower-case letter. The first variant is “a”, the next, “b”, and so on. If you have more than 26 variants the sequence will continue with “aa”, “ab”, etc.

Sample PHP Script

<?php
// If you created a login form with fields 
// 'Your email' and 'Your password', 
// then you will map these fields to:
'Your email' => 'email' 'Your password' => 'password' // Then after submit in your endpoint you can // get these data with code: $email = trim( strip_tags( $_POST[ 'email' ] ) ); $password = trim( strip_tags( $_POST[ 'password' ] ) ); // It can't be more simple. // You can get page data... $page_id = $_POST[ 'page_id' ]; $page_url = $_POST[ 'page_url' ]; $variant = $_POST[ 'variant' ];  ?>
Have more questions? Submit a request
Was this article helpful?
0 out of 0 found this helpful

Need Further Help?

Tell us what you need and we will be happy to assist you.

Our team of expert support staff and our community can answer your questions. Submit a ticket, or reach out on live chat!