If you need to see what kind of responses you’re going to get from our webhooks, or you need to tunnel directly to your developer environment, there are a selection of tools out there to help you. Here we’ll look at a few different options and how to set them up.

RequestBin

[RequestBin](http://requestb.in/) works by providing a unique URL that you can set as your endpoint for both the Inbound Parse and the Event Notifications Webhooks. You can then check this URL to see what responses you’re getting back from us.

Setup

You may generate a unique URL by creating a “RequestBin”

The URL looks like this:

1
http://requestb.in/19e3ycm1

Receive Event Notifications Data

To have all your event notifications posted to this URL first turn on the Event Notification app in your dashboard.

Next, select which notifications you would like to have send to RequestBin (if in doubt, tick all the checkboxes to turn them all on) and enter the unique URL generated by RequestBin as your Post Event URL at the bottom of the page. Once you’ve saved the changes, all event notifications will be sent to RequestBin for you to check.

Receive Inbound Parse Data

Before you can receive data through the Inbound Parse Webhook, you will need to follow the instructions for making changes to your MX records in your DNS setup.

Once that has been completed you can setup your Inbound Parse. In this case, you need to add your RequestBin URL as the URL to POST to.

Seeing the results

After completing the setup for your chosen webhook, the results can be found by heading to your RequestBin unique URL in a browser.

ngrok

ngrok is a tool for creating a local tunnel to your machine, it makes testing webhooks locally extremely easy.

Start by signing up so you can use all the features available. In particular, the ability to use custom subdomains. This will remove the need to amend your webhook settings each time you run ngrok.

Setup

To get up and running, install and enter the following in your CLI

1
$ ngrok 3000

This would open up a connection to port 3000 on your local machine, at a URL like http://3a4bfceb.ngrok.com. You may then put this URL as your the URL for your Parse Webhook or Event Webhook.

Rather than having to change this every time you restart ngrok, specify the subdomain flag:

1
$ ngrok -subdomain=myappname 3000

This will open up port 3000 and make it accessible at http://myappname.ngrok.com.

Seeing what’s happening

Additionally, ngrok runs a web interface at http://localhost:4040, that allows you to monitor requests in and out, as well as giving you the ability to replay previous requests at the click of a button.

More information

For more information on what you can do with ngrok, check out their documentation.

Runscope

Runscope is a tool for debugging APIs. It acts as a proxy, collecting all data sent to it and passes it on to another point. You may then, later, review what was sent to the API you’re debugging.

This can be extrordinarily helpful when debugging webhooks, and Runscope has a tutorial on how to do this.