Test Webhooks

Before deploying your webhook handler to production, you'll want to verify it works correctly. This guide covers two approaches: using webhook.site for quick testing, and ngrok for testing your actual code.

Option 1: Quick Test with webhook.site

webhook.site is a free tool that gives you a temporary URL to receive and inspect webhook payloads. It's perfect for understanding the event structure before writing any code.

Option 2: Test Your Code with ngrok

ngrok creates a secure tunnel from the internet to your local machine. This lets you test your actual webhook handler code with real Fungies events.

Install ngrok

# macOS (Homebrew)
brew install ngrok

# Or download from https://ngrok.com/download

Start the Tunnel

Run your local server, then create a tunnel to it:

# Start your local server (example: running on port 3000)
npm run dev

# In another terminal, create the tunnel
ngrok http 3000

You'll see output like this:

Session Status                online
Forwarding                    https://abc123.ngrok.io -> localhost:3000

Register Your Tunnel URL

1. Copy the https://...ngrok.io URL
2. Go to Fungies Dashboard → Developers → Webhooks
3. Create a webhook with your ngrok URL + your endpoint path (e.g., https://abc123.ngrok.io/webhooks/fungies)

Send Test Events

Use the Test button in the Dashboard to send events to your local server. Check your terminal logs to see the events being received and processed.

Testing Best Practices

Use a Separate Webhook for Testing

Create a dedicated webhook endpoint for development to avoid mixing test events with production data.

Verify Your Error Handling

Test how your handler responds to:

• Invalid payloads
• Missing required fields
• Duplicate events (same event ID sent twice)
• Network timeouts

Log Everything During Development

app.post('/webhooks/fungies', (req, res) => {
  console.log('Received webhook:', {
    headers: req.headers,
    body: JSON.stringify(req.body, null, 2)
  });
  
  // ... your handler logic
  
  res.status(200).send('OK');
});

Checklist Before Going Live

Next Steps