How to use ngrok (or other localhost tunnelling software) to test callback handlers

Updated Oct 22, 2025

In this article

Run ngrok or some other localhost tunneling software

We'll use ngrok for our example, as it's relatively easy to setup.

Once you have ngrok up and running, it'll look like this:

Python ngrok

We recommend using https as it's more secure.

  1. Log in to sign.dropbox.com with your development account credentials.
  2. Hover over your email address in the upper-right corner and click Settings > API. Here you can retrieve your API key.
  3. Place the ngrok.io URL value into the Account Callback box, and click TEST. If your callback handler is setup correctly, you'll see the success message below:
Callback success message

Notes:

  • If you want to continue receiving callbacks to that URL, make sure to click Save at the bottom of the page.
  • If you received an error, keep in mind that the two things Dropbox Sign looks for is a 200 response with the string "Hello API Event Received" somewhere in the body.

Was this article helpful?

Let us know how why it didn't help:

Thanks for letting us know!

Thanks for your feedback!

Other ways to get help