{"id":20498,"date":"2018-04-02T05:27:43","date_gmt":"2018-04-02T09:27:43","guid":{"rendered":"https:\/\/docs.gravityforms.com\/?p=20498"},"modified":"2021-12-10T17:34:13","modified_gmt":"2021-12-10T22:34:13","slug":"populate-webmerge-documents-webhooks-addon","status":"publish","type":"post","link":"https:\/\/docs.gravityforms.com\/populate-webmerge-documents-webhooks-addon\/","title":{"rendered":"How to Populate WebMerge Documents using the Webhooks Add-On"},"content":{"rendered":"\n

Introduction<\/h2>\n\n\n\n

Using the Gravity Forms Webhooks Add-On it is possible to populate WebMerge<\/a> documents when a form is submitted.<\/p>\n\n\n\n

Note:<\/strong> This article assumes you have installed and activated<\/a> the Webhooks Add-On and have created a document in your WebMerge account<\/a>. If not, you will need to do so before any of the functionality in this article can be used.<\/p>\n\n\n\n

Configuring the Webhook<\/h2>\n\n\n\n

To configure webhooks for a form go to your Form Settings<\/strong> and click on the Webhooks<\/strong> tab and then click the Add New<\/strong> button.<\/p>\n\n\n\n

Next, you’ll need to configure the request that is being made.<\/p>\n\n\n\n

\"WebMerge<\/a><\/figure>\n\n\n\n

Name<\/h4>\n\n\n\n

Enter a name for your feed. This can be anything you want as it is only used for identification purposes on the feeds list page and in the add-on log.<\/p>\n\n\n\n

Request URL<\/h4>\n\n\n\n

Enter the Merge URL<\/strong> from your WebMerge documents Merge tab. e.g. https:\/\/www.webmerge.me\/merge\/12345\/abcde<\/strong><\/p>\n\n\n\n

When performing a test request append the test=1<\/strong> query string parameter to the URL so the merge does not count against your accounts merge credits e.g. https:\/\/www.webmerge.me\/merge\/12345\/abcde?test=1<\/strong><\/p>\n\n\n\n

Request Method<\/h4>\n\n\n\n

Select the POST<\/strong> choice as the request method.<\/p>\n\n\n\n

Request Format<\/h4>\n\n\n\n

Select the JSON<\/strong> choice as the request format.<\/p>\n\n\n\n

Request Headers<\/h4>\n\n\n\n

There are no request headers to configure when integrating with WebMerge.<\/p>\n\n\n\n

\"WebMerge<\/a><\/figure>\n\n\n\n

Request Body<\/h4>\n\n\n\n

Select the Select Fields<\/strong> choice.<\/p>\n\n\n\n

Field Values<\/h4>\n\n\n\n

Configure rows for each of your documents merge fields. Click the add item icon (+) to add new rows.<\/p>\n\n\n\n

You can find the keys to use on your WebMerge documents Test tab, they are the labels above each test value input, ignoring the JSON merge field at the end.<\/p>\n\n\n\n

\"\"<\/a><\/figure><\/div>\n\n\n\n

For the values you can select from the form fields, entry meta, or Add Custom Value<\/strong> which will display a text input which also supports Merge Tags<\/a>.<\/p>\n\n\n\n

Webhook Condition<\/h4>\n\n\n\n

If WebMerge document population should be conditional based on the value of a form field select the Enable Condition<\/strong> checkbox and then configure the rules which should be met for this request to be sent.<\/p>\n\n\n\n

Alternative Method<\/h2>\n\n\n\n

If you don’t have an Elite or legacy Developer license and would prefer not to upgrade your existing license<\/a>, you can still populate WebMerge documents by using one of the following methods:<\/p>\n\n\n\n