Lead Capture Integration

Automatically capture leads from your website and advertising campaigns

Your Webhook URL
https://admin.vivosmartlife.co.za/api/functions/createLeadFromWebhook

Important: Make sure you've set your WEBHOOK_SECRET in the Base44 dashboard before using this webhook.

Website Forms
Website Integration

Connect your website contact forms to automatically capture leads in real-time.

  • Contact form submissions
  • Quote request forms
  • Newsletter signups
Google Ads
Google Ads Leads

Capture leads from Google Ads Lead Form Extensions automatically.

  • Search campaign leads
  • Display campaign leads
  • YouTube campaign leads
Zapier/Make
Automation Tools

Use Zapier or Make.com to connect hundreds of services and apps.

  • Facebook Lead Ads
  • LinkedIn Lead Gen
  • Any webhook-enabled service
Example Request Payloads

Website Form Submission

{
  "secret": "your_webhook_secret_here",
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890",
  "company": "Acme Corp",
  "message": "I'm interested in your services",
  "source": "Website"
}

Google Ads Lead

{
  "secret": "your_webhook_secret_here",
  "name": "Jane Smith",
  "email": "jane@example.com",
  "phone": "+0987654321",
  "company": "",
  "message": "Google Ads Lead Form submission",
  "source": "Google Ads"
}

Zapier Configuration

// Zapier Webhooks POST Action
// URL: https://admin.vivosmartlife.co.za/api/functions/createLeadFromWebhook
// Method: POST
// Headers:
{
  "Content-Type": "application/json",
  "X-Webhook-Secret": "your_webhook_secret_here"
}
// Body:
{
  "name": "{{Lead Name}}",
  "email": "{{Lead Email}}",
  "phone": "{{Lead Phone}}",
  "company": "{{Lead Company}}",
  "message": "{{Lead Message}}",
  "source": "{{Source Name}}"
}
Test Your Webhook

Use this cURL command to test your webhook integration. Make sure to replace your_webhook_secret_here with your actual webhook secret.

curl -X POST https://admin.vivosmartlife.co.za/api/functions/createLeadFromWebhook \
  -H "Content-Type: application/json" \
  -d '{
    "secret": "your_webhook_secret_here",
    "name": "Test Lead",
    "email": "test@example.com",
    "phone": "+1234567890",
    "message": "Test lead from curl",
    "source": "Manual Test"
  }'
Request Parameters
ParameterTypeRequiredDescription
secretString
Required
Your webhook secret for authentication
nameString
Required
Lead's full name
emailString
Optional
Lead's email address
phoneString
Optional
Lead's phone number
companyString
Optional
Lead's company name
messageString
Optional
Lead's message or inquiry
sourceString
Optional
Lead source (defaults to "Website")
Security Best Practices
1
Keep Your Secret Safe: Never expose your WEBHOOK_SECRET in client-side code or public repositories.
2
Use HTTPS Only: Always use HTTPS when sending requests to the webhook to ensure data is encrypted in transit.
3
Monitor Webhook Activity: Regularly check your leads to ensure only legitimate submissions are being captured.
4
Rotate Secrets Periodically: For maximum security, consider rotating your webhook secret every few months.