# Webhooks

Webhooks allow your application to receive real-time updates from MangoForm when events happen, such as when a form is submitted.

## What are Webhooks?

Webhooks are a way for MangoForm to send automatic notifications to your application when specific events occur. Instead of continuously polling our API for changes, your application can receive real-time updates.

### How Webhooks Work

1. **Configure Endpoint**  
   Set up a URL in your application that will receive webhook events from MangoForm.

2. **Register Webhook**  
   Add your endpoint URL to MangoForm's webhook settings for your form.

3. **Receive Events**  
   MangoForm sends HTTP POST requests to your endpoint when events occur.

### Benefits of Using Webhooks

- Real-time updates without polling  
- Automate workflows based on form submissions  
- Integrate with your existing systems  
- Reduce API usage and improve performance

## Getting Started with Webhooks

1. **Create an endpoint in your application**  
   Your endpoint should be able to receive HTTP POST requests and process JSON payloads.
   
   ```javascript
   // Example Node.js endpoint using Express
   const express = require('express');
   const app = express();
   app.use(express.json());
   
   app.post('/webhook/mangoform', (req, res) => {
     const event = req.body;
     
     // Process the webhook event
     console.log('Received webhook:', event);
     
     // Always respond with a 200 status code to acknowledge receipt
     res.status(200).send('Webhook received');
   });
   
   app.listen(3000, () => {
     console.log('Webhook server running on port 3000');
   });
   ```

2. **Register your webhook in MangoForm**  
   Go to your form settings and add your webhook endpoint URL.
   
   1. Navigate to your form in the dashboard
   2. Go to Settings → Integrations → Webhooks
   3. Click "Add Webhook" and enter your endpoint URL
   4. Optionally, set up a secret key for security
   5. Save your webhook configuration

3. **Test your webhook**  
   You can test your webhook by submitting a test form or using the "Test" button in the webhook settings.

## Need More Help?

Check out our detailed guides for more information on working with webhooks:

- [**Webhook Setup Guide**](/content/docs/webhooks/setup/index.html)  
  Step-by-step instructions for setting up and testing webhooks.
- [**Event Types Reference**](/content/docs/webhooks/events/index.html)  
  Detailed information about all webhook event types and their payloads.
- [**Security Best Practices**](/content/docs/webhooks/security/index.html)  
  Learn how to secure your webhook implementation.
- [**Webhooks API**](/content/docs/api/webhooks/index.html)  
  API reference for managing webhooks programmatically.