WebMerge

With our WebMerge integration, you can easily create PDF documents on the fly from your form submissions and email them to yourself or your customers.

This could come in handy for a number of things.  For example, you could use this integration if you want to create a nice looking ticket for an event or if you are accepting an online application that needs to be printed and signed. 

To add the WebMerge integration to your form, go to Settings > Integration > Documents and then click the Add button next to WebMerge. The integration will be added below the Integrations tab where you can begin adding your WebMerge credentials.

If you do not have a WebMerge account:

Click "Start Free Trial" button. This will redirect to WebMerge and then back to Formstack. It will import the form into a WebMerge document and automatically set up the Formstack integration settings. 

Select the document from the drop-down that you would like to integrate with your form.  This will automatically load the fields from the document.

For each of the fields in the document that you would like to fill, select the matching field on your form from the drop-down next to the name.  At the bottom of the Document Fields, you will also notice a Custom Fields section.  This is useful if you want to send over information that is not in your document.  For example, if you collect an email address on your form but don't put that email address in your PDF, you would need to send the email address separately.


If you already have a WebMerge account: 

Click "Login to WebMerge." Then enter your WebMerge API Key and API Secret (obtain from your account at http://www.webmerge.me/manage/account.php?page=api) and click Continue.

If you have implemented the WebMerge integration at least once, your API Key and API Secret will automatically populate.

From here, there are two options for document creation:

If you have a document built in WebMerge, click "Choose document" This will show the rest of the integration settings so you can select the document you want to use

If you need to create a new document in WebMerge, click "Create new document using this form" button. This will auto-create a document in WebMerge with your form HTML and setup the integration, auto-mapping all the fields.

Data Route 

This option can be used to automatically send incoming data to multiple documents in your account. You can even define specific conditions (based on logic) that determine which documents to run. To use this, you will first need to create a Data Route in your WebMerge account and then define your Rules and Settings in WebMerge. This will determine how and where the data submitted in the forms will populate the data in your WebMerge files.  

Note: Data Route rules in WebMerge are different from the Data routing rules on the forms.

Error Handling

You can choose to be alerted if and when the WebMerge integration fails. Enter one email address per line and if something goes wrong upon submission you will receive an email letting you know!

Re-Running the Integration

If an integration fails upon submission, check your integration settings for errors in API or login credentials or in the mapping of form fields. Then, click on a submission in your database. You will see ‘Integration Status’ on the left side of the submission. Click "Run Again". The integration will begin running. If it is successful, a green "Success" message will appear. If it is not, a red "Failed” message will be shown. If this happens, go back to your integration settings and check for other errors in setup.