How to create a Form Handler

Warning

You will need to have a form built on your own website before creating a Form Handler.

You will also need knowledge of API and POST requests to allow the information from your form to be sent to Insightly.

Form Handlers collect data from your forms, then automatically create or update records within Insightly Marketing.

When you create a Form Handler, you will map the fields of your pre-existing form to Prospect fields in Insightly. This will eliminate the need for manually entering data into Insightly after a Prospect has filled out your form.

To create a Form Handler:

  1. Select Forms from the navigation bar. Click New Form Handler.
    Form_handler_1.png
  2. Enter your Form Handlers information. The Name field is required. If you select Specific URL from the Success Page or Error Page dropdowns, you will be required to enter a URL.
    Form_handler_2.png
  3. If needed, edit the Duplicate Handling field. By default, it is set to update existing records instead of creating duplicate records.
  4. The Email field is the only required field for a Form. Click Add Form Field to add other fields for your Prospects. You can choose to make additional fields optional or required.

    When entering the Field Name, make sure it matches the field's name in the within the coding of your form. You cannot use spaces in the Field Name field.
    Form_handler_3.gif
  5. Click Save.
    Form_handler_4.png

To add Finish Actions: 

Finish Actions allow you to add an automated activity that is triggered when someone submits your form.

Finish Actions will typically occur immediately after a form has been submitted and cannot be scheduled for a later date or time. They can, however, be assigned conditional criteria that will not allow the action to occur unless the submitted form has met the criteria that has been set. 

  1. Go to the Finish Actions tab. Click Add Finish Action.
    Finish_action_1.png
  2. Select an action from the dropdown.
    Finish_Action_2.png
  3. Enter the required fields. You can optionally add conditional criteria. For example, this Send Email action could require that the employee count needs to be greater than 10 for the action to be triggered.
    Finish_action_4.png
  4. Click Save Finish Action.
    Finish_Action_5.png

Connecting the Form Handler to your form

When you are finished, you can add the Form Submit URL field to your API POST request.

Insightly Form Handlers will only accept POST form submissions; "multipart/form-data" posts will not be accepted because Form Handlers cannot support file uploads.

Form_submit_URL_1.png

Was this article helpful?