Skip to main content

​
Overview

While Lindy supports over 5,000 integrations out of the box, webhooks provide the ultimate flexibility for custom integrations. Use webhooks to trigger agent workflows from any system that can make HTTP requests — your own applications, third-party services, or custom scripts.
Webhooks are ideal when you need real-time event processing or when working with systems that don’t have native Lindy integrations.

​
Adding a Webhook Trigger

Add Trigger menu showing Webhook option in popular triggers and other triggers sections
To get started:
  1. Click Add Trigger in your workflow
  2. Search for “Webhook”
  3. Select Webhook Received trigger
The webhook trigger appears in both the “Popular” section and under “Other Triggers” for easy access.

​
Configuration Options

Webhook configuration interface showing webhook selection and follow-up behavior options

​
Webhook Selection

Choose an existing webhook or create a new one. Each webhook has its own unique URL and security settings.

​
Follow-up Behavior

Follow-up behavior dropdown showing Handle in same task, Create new task, and Ignore options
Configure how your agent processes webhook requests:
OptionDescription
Handle in same taskProcess follow-up requests in the same workflow
Create new taskSpawn a new task for each follow-up webhook call
IgnoreIgnore follow-up webhook requests

​
Creating a New Webhook

Create new webhook interface with name field and webhook list
  1. Click “Select an option” → “Create new”
  2. Enter a descriptive name for your webhook
  3. Press Enter to save and select the webhook
Each webhook gets a unique URL in the format: 
https://public.lindy.ai/api/v1/webhooks/[unique-id]

​
Security with Secret Keys

Generate Secret button and copy to clipboard option for webhook security
Protect your webhooks from unauthorized access:
  1. Click Generate Secret to create a secure token
  2. Copy the secret key immediately
Secret key display with warning that it's only shown once
The secret key is only shown once! Copy it now and store it securely. You’ll need to include this in the Authorization header of all webhook requests.

​
Using the Secret Key

Include the secret in your webhook requests: 
Authorization: Bearer [your-secret-key]

​
Webhook + AI Agent Pattern

Webhook trigger followed by AI Agent node in workflow
The most powerful webhook pattern combines the trigger with an AI Agent that can intelligently process incoming data:

​
AI Agent Configuration

After your webhook trigger, add an AI Agent to:
  • Analyze incoming webhook data
  • Make decisions based on content
  • Execute multiple actions conditionally
  • Handle complex business logic
AI Agent skills panel showing Send POST Request to Callback as a suggested skill

​
Essential AI Agent Skills

Suggested skill for webhooks:
  • Send POST Request to Callback - Respond back to the original request sender
Additional powerful skills to add:
  • HTTP Request - Call other APIs based on webhook data
  • Update Spreadsheet - Log webhook data
  • Send Email/Slack - Notify teams
  • Search Knowledge Base - Enrich with context
  • Create Calendar Event - Schedule based on webhooks
  • Run Code - Custom data transformations

​
Working with Webhook Data

Access webhook data from the trigger in any subsequent step using the following variables:
Data SourceVariable ReferenceDescription
Request Body{{webhook_received.request.body}}The full JSON payload from the request.
Headers{{webhook_received.request.headers}}All request headers.
Query Params{{webhook_received.request.query}}Any parameters from the webhook URL.
Use AI Prompt mode in action fields to intelligently extract and use specific fields from your webhook payload.

​
Callback Responses

When you need to respond to the webhook sender:
  1. Include a callbackUrl field in your webhook request body
  2. Add the “Send POST Request to Callback” action
  3. Configure your response data
This enables two-way communication between your external system and Lindy.
Common callback scenarios:
  • Acknowledge receipt with status
  • Return processed results
  • Send error messages
  • Provide async job IDs

​
Best Practices

Always use secret keys and validate incoming requests to protect your workflows from unauthorized access.
Add error handling conditions after webhook processing to manage unexpected issues and ensure reliability.
Use tools like Postman to test your webhook endpoints with different scenarios before deploying to production.

HTTP Request

Make outbound API calls from Lindy

Agent Steps

Build intelligent webhook processors

Conditions

Route webhook data conditionally

Knowledge Base

Enrich webhook data with context