> For the complete documentation index, see [llms.txt](https://lamatic.ai/llms.txt).

# Webhook Integration Guide


Webhooks are user-defined HTTP callbacks that trigger events in external systems. They allow you to automate flow by sending real-time notifications when specific events occur.

![img_5.png](./img_5.png)

Webhooks enable asynchronous automation in [Lamatic.ai](http://Lamatic.ai), providing high-performance triggers to integrate with your applications or third-party services easily.

## Webhooks Overview

Webhooks facilitate seamless communication between systems in Lamatic. Here’s a quick breakdown of how they function:

- **Unique Identifier**: Each webhook-triggered flow has a distinct webhook ID.
- **Request Handling**: Incoming requests to this ID initiate the configured flow.
- **Flow Execution**: The flow runs predefined actions based on your setup.

If your webhook receiver is protected by a firewall or IP-based access policy,
  see [IP Allowlisting](/docs/ips) before enabling production traffic.

## Setting Up Webhooks

Follow these steps to configure a webhook in Lamatic:

1. **Create a New Flow**  
   Begin by creating a new flow within your Lamatic dashboard.

2. **Add Webhook Node**  
   In the "Nodes" section, search for "webhook" and add it to your flow.

3. **Configure Endpoint**  
   Copy the generated webhook endpoint and select "Fetch" to activate it.

4. **Test the Webhook**  
   Send a sample payload or event to the endpoint to verify functionality. A webhook accepts any JSON body, whatever you send becomes the trigger node's output, available to downstream nodes as `{{triggerNode_1.output.<field>}}`.

   ```bash
   curl -X POST "<YOUR_WEBHOOK_ENDPOINT>" \
     -H "Content-Type: application/json" \
     -d '{
       "topic": "hello world",
       "source": "my-app"
     }'
   ```

   With the payload above, `{{triggerNode_1.output.topic}}` resolves to `"hello world"` anywhere later in the flow.

5. **Build Your Flow Logic**  
   Once the test payload is received, continue developing your flow logic based on your automation needs.

## Accessing Automatic Documentation

Lamatic automatically provides webhook documentation to streamline integration:

- **Locate Documentation**  
  Go to the "Install Steps" or "Setup" section in your Lamatic dashboard.

- **Review Instructions**  
  Use the provided documentation for step-by-step integration guidance.

## Deploying and Utilizing Webhooks

After configuring your flow, activate and start using your webhook:

1. **Deploy the Flow**  
   This step finalizes your webhook setup within the project.

2. **Send Requests**  
   Begin sending requests to your webhook endpoint to trigger the flow.

3. **Monitor Activity**  
   Check the "Logs" section to review incoming requests and troubleshoot as needed.

Lamatic’s webhook capabilities allow you to build robust, event-driven flow that seamlessly integrate with your systems, creating efficient automation possibilities.