How to test BoldSign webhooks locally

To test webhook callbacks locally, you need your local web server accessible publicly. Cloudflare Tunnel provides an easy way to expose your local environment over the internet securely.

Steps to Set Up Your Callback Endpoint

Install Cloudflare Tunnel

If you haven’t installed Cloudflare Tunnel yet, follow the official guide:

• Cloudflare Tunnel Setup Guide

Expose Your Local Web Application

Run the following command to expose your local application:

cloudflared tunnel --url <Your Local Web Application URL> 

Example:

cloudflared tunnel --url http://localhost:7080 

Receive Your Public URL

After running the command, you will see output similar to the following:

Thank you for trying Cloudflare Tunnel. Doing so without a Cloudflare account is a quick way to experiment. However, these account-less tunnels have no uptime guarantee and are subject to Cloudflare's Online Services Terms of Use (https://www.cloudflare.com/website-terms/). For production use, consider creating a named tunnel: https://developers.cloudflare.com/cloudflare-one/connections/connect-apps

Requesting new quick Tunnel on trycloudflare.com...
+--------------------------------------------------------------------------------------------+
|  Your quick Tunnel has been created! Visit it at (it may take some time to be reachable):  |
|  https://dispatch-relates-keith-captured.trycloudflare.com                                    |
+--------------------------------------------------------------------------------------------+ 

In this example, your public URL is https://dispatch-relates-keith-captured.trycloudflare.com. Use this URL as the webhook callback endpoint in your BoldSign webhook settings.

Add a Webhook

• Navigate to API → Webhooks.
• Click Add Webhook.

Configure Webhook Details

Complete the webhook configuration form:

• Select Account Level.

• Enter a descriptive name for your webhook.
• Provide a valid publicly accessible HTTPS webhook URL.

• Click Verify. BoldSign will send a verification HTTP POST request with this JSON payload.

• Ensure your endpoint responds with HTTP 200 OK within 10 seconds. Upon successful verification, you’ll receive an acknowledgment message.
• Choose the specific events to trigger webhook callbacks and click Save to finalize the webhook setup.