Setting up your endpoint to listen for callbacks
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
Step 1: Install Cloudflare Tunnel
If you haven't installed Cloudflare Tunnel yet, follow the official guide:
Step 2: 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:5173
Step 3: 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://seasonal-deck-organisms-sf.trycloudflare.com | +--------------------------------------------------------------------------------------------+
In this example, your public URL is https://seasonal-deck-organisms-sf.trycloudflare.com. Use this URL as the webhook callback endpoint in your BoldSign webhook settings.
Step 4: Configure Webhook URL in BoldSign
- Navigate to your BoldSign dashboard and set your Cloudflare-generated URL as the webhook endpoint.
- Ensure your local application correctly handles incoming webhook requests.