Step 1 – Configure the WebHook

To connect your lead-gen form to your server, visit the “Lead-Gen Form Results” area on your landing page overview screen (below the A/B Test Centre) and click the Configure WebHook link. 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, Unbounce will send the following data to your selected URL.

Note:

• We include the submitter's IP address with the data.json object
• We only include the extra_data fields if RapLeaf has been enabled

{
  "full_name": ["Steve Jobs"],
  "email_address": ["steve@apple.com"],
  "earnings": ["More than you can possibly imagine"],
  "what_would_you_like_our_product_to_do?": ["Dice", "Julienne Fries"],
  "how_did_you_hear_about_us?": ["Can't Remember"],
  "ip_address": "238.17.159.4"
}

<?xml version='1.0'?>
<form_data>
  <full_name>Steve Jobs</full_name>
  <email_address>steve@apple.com</email_address>
  <earnings>More than you can possibly imagine</earnings>
  <what_would_you_like_our_product_to_do?>
    <entry>Dice</entry>
    <entry>Julienne Fries</entry>
  </what_would_you_like_our_product_to_do?>
  <how_did_you_hear_about_us?>Can't Remember</how_did_you_hear_about_us?>
  <ip_address>238.17.159.4</ip_address>
</form_data>

{
  "rapleaf": {
    "age": "25-35",
    "location": "San Francisco, California, United States",
    "gender": "Male"
  }
}

<?xml version='1.0'?>
<extra_data>
  <rapleaf>
    <age>25-35</age>
    <location>San Francisco, California, United States</location>
    <gender>Male</gender>
  </rapleaf>
</extra_data>

URL Parameter Replacement

There's also a handy feature you can use to do some simple customization of the URL you're posting to.  You can pass data from your form into parameters in the URL the webhook posts to.  This is useful for doing simple mapping of form field names to field names expected by the target script.

Let's say you had a form with a "name" field in it, and you wanted to pass this along as a "customer_name" field.  You could specify your webhook's "URL for POST" as follows:

http://mygreatcompany.com/some_script.php?customer_name=(name)

When a form is submitted, we'll replace the "(name)" token with the value of the name field from the form.  You can add as many parameters as you like, just be aware that some servers have a limit for how long the query string can be.

Sample PHP Script

Following is a simple PHP script that demonstrates how to accept a POST request from the webhook, and email the results.