What’s a WebHook?
A WebHook is just 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?
For our Premium users, WebHooks make it easier to integrate two systems. The most common use for our Form Submit WebHook is to feed leads into your CRM. But there are lots of other things you could do as well, such as sending yourself an email or plotting addresses on Google Earth.
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.
However, the very nature of a WebHook assumes that you have some ability to write code (or bribe a friend or colleague who does). You need to have a server that can accept a POST request (like what you’d get from a form submission), and be able to write a script that does something in response.
Step 1 – Configure the WebHook
To connect your lead-gen form to your server you'll need to click Edit on your form and select the "Webhooks" integration option. If you just want to test it out, you can use a PostBin URL (from www.postbin.org) as a place to temporarily send your form data and examine the data format.
Step 2 – 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.
|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:Securing your Webhook
'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' ]; ?>
If you have a Server Token Authorization Key, it can be added on this screen to set up a secure connection.
If not, this step should be skipped.