If you are setting up a custom integration, you've come to the right spot!  Each WebMerge Document and Data Route has a unique Merge URL that is a webhook endpoint.  This means we listen for an HTTP POST (name/value pairs) at this URL.

Here is an example Document Merge URL:



Now, imagine our document has a few fields in it: Name, Email, Phone, and Address.  The next step will be to send the data for each field in the webhook request.  We're going to use name/value pairing to send the data.

Here is an example HTTP request:

POST https://www.webmerge.me/merge/12345/abcde



There are a few options (GET parameters) you can add to the Merge URL

  • test=1 : This will put the merge in "test mode" and not count against the merge credits

  • download=1 : This will return the document in HTTP response.  Simply save the response to save the document on your server


That should do it!

Have more questions? Submit a request


  • Avatar
    André Hess

    I'm sending a post message but I continuously get a message "Please send merge variable values" although my parameters are correct. https://www.webmerge.me/merge/122902/7xzvk8?resumen=hola&precio=22&metros=100

  • Avatar
    Jeremy Clarke

    Hi Andres,

    When sending your data via the URL (that's a GET request, not a POST), you need to use a "&_use_get=1" parameter in the URL too. This tells our system to look in the URL for your merge fields.


  • Avatar
    Porter Davis

    Can I send JSON with multiple records to generate a combined document ? I only see JSON of a single record.

  • Avatar
    Jeremy Clarke

    Hi Porter,

    Yes, you can do that using a Data Route. In your data route rule, you'll select the "Repeat this rule" checkbox, then enter something like this in the box:


    We will detect the JSON array and then for each item in the array, we'll populate a document.

    More info on data routes: https://support.webmerge.me/hc/en-us/articles/206527136-Combine-Multiple-Documents


Please sign in to leave a comment.
Powered by Zendesk