Webhooks Overview

Webhooks are the primary way to send leads to Lead Warmer. When your CRM or lead source detects a new lead, it sends a webhook to Lead Warmer, which triggers the video generation process.

How It Works


Your CRM → Webhook → Lead Warmer → Video Generation → Email Delivery

Lead Created: Your system detects a new lead
Webhook Sent: Your system sends lead data to Lead Warmer
Lead Processing: Lead Warmer validates and processes the data
Campaign Matching: Lead is matched against active campaigns
Video Generation: AI generates a personalized video
Email Delivery: Video is sent to the lead

Your Webhook Endpoint

Each organization has a unique webhook URL:


https://api.leadwarmer.net/webhooks/ingest/{webhook-id}

Find your webhook URL in Settings > Webhooks.

Supported Methods

Method	Description
`POST`	Send new leads (primary method)
`GET`	Health check (returns 200 OK)

Response Codes

Code	Description
`202`	Lead accepted for processing
`400`	Invalid payload format
`401`	Invalid or missing signature
`429`	Rate limit exceeded
`500`	Internal server error

Success Response


{
  "success": true,
  "lead_id": "lead-uuid-here",
  "message": "Lead accepted for processing"
}

Error Response


{
  "success": false,
  "error": "Invalid payload: missing required field 'email'",
  "code": "INVALID_PAYLOAD"
}

Rate Limits

Default: 100 requests per minute
Enterprise: 1000 requests per minute
Rate limit headers included in responses

Next Steps

Configuration - Set up your webhook
Payload Format - Required and optional fields
Security - Signature verification