Overture allows you to post information from a form on your website to create contacts and bookings.

This article shows you how to setup Overture to allow access, an example form and finally a list of all the fields available to post to.

Inside your Overture account, as an admin user, head over to your settings and in the sidebar look for the ‘Custom Web Form’ option.

To begin you will need a web form key, click on the ‘Generate Key’ button.

This key will need to be included in your form inside a hidden input as the example shows below.

Example form code

<form method="post" action="https://overturehq.com/formapi/webform/submit.json">
  <label>Name:</label>
  <input type="text" name="personName">
  <label>Email Address:</label>
  <input type="text" name="personEmailWork">
  <label>Phone Number:</label>
  <input type="text" name="personPhoneWork">
  <label>Event Date:</label>
  <input type="text" name="Date">
  <label>What would you like to discuss with us?</label>
  <textarea name="personNote">
  </textarea>
  <input type="submit" value="Send Enquiry">
  <input type="hidden" name="key" value="Mzk4MzkwMTQxNjM=">
</form>


In the example form also note that the URL in the action that the form must post to.

Finally, you will also need to setup a referrer to tell Overture where you will be posting data from. To do this click on the ‘Add Field’ button and enter the URL of the referrer i.e. the URL that the form will be sending the information from.

You can now go ahead and build out the rest of your form using the fields listed below as the name field inside the form inputs.

Fields available

Contacts

  • 'personName'
  • 'personFirstName'
  • 'personLastName'
  • 'personEmailWork'
  • 'personEmailPersonal'
  • 'personPhoneWork'
  • 'personPhonePersonal'
  • 'personWebsiteWork'
  • 'personWebsitePersonal'
  • 'personAddressLine1'
  • 'personAddressLine2'
  • 'personAddressLine3'
  • 'personAddressCity'
  • 'personAddressState'
  • 'personAddressZip'
  • 'personAddressCountry'
  • 'personNote'
  • 'companyName'
  • 'companyEmailWork'
  • 'companyPhoneWork'
  • 'companyWebsiteWork'
  • 'companyAddressLine1'
  • 'companyAddressLine2'
  • 'companyAddressLine3'
  • 'companyAddressCity'
  • 'companyAddressState'
  • 'companyAddressZip'
  • 'companyAddressCountry'

Bookings

  • 'booking1Date'
  • 'booking1Name'
  • 'booking1Note'
  • 'booking1ArtisteName'
  • 'booking1VenueName'
  • 'booking1VenueAddressLine1'
  • 'booking1VenueAddressLine2'
  • 'booking1VenueAddressLine3'
  • 'booking1VenueAddressCity'
  • 'booking1VenueAddressState'
  • 'booking1VenueAddressZip'
  • 'booking1VenueAddressCountry'

Key

  • 'key' - Required in the value attribute of a hidden input field

The endpoint will respond with json encoded data.  We recommend that the form is submitted asynchronously. Here's an example of how that might be done using jQuery and the jQuery form plugin.

<script type="text/javascript">
  // Form to submit via ajax.
  $("form").ajaxForm({
    "clearForm": false,
    "resetForm": true,
    "beforeSubmit": function() {
    },
    "success": function(json) {
      if (json.success == true)
      {
        // Form has submitted successfully.
        alert("Thank you for getting in touch.");
      } else {
        for (name in json.errors) {
          $("form").find("[name$='" + json.errors[name] + "']").css("border-color", "red");
        };
      };
    },
    "error": function() {}
  });
</script>