Webhook

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:

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

 

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

Name=John+Smith&Email=john.smith@email.com&Phone=123-555-7890&Address=123+S+Main

 

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

2 Comments

  • 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.

    Thanks!

Please sign in to leave a comment.
Powered by Zendesk