Integrations

Overview

LeadZap integrations fire automatically when a lead generation job completes. Every lead in the job — with enriched emails, phone numbers, social URLs, and people data — is delivered to your configured endpoint or CRM.

You can set up integrations from the Integrations tab in your dashboard. Each user can configure up to 10 integrations. All enabled integrations are triggered on every job completion.

Supported Types

Webhook Integration

Send a JSON payload of all leads to any HTTP endpoint whenever a job finishes. Perfect for connecting to Zapier, Make, n8n, or your own backend.

Setup

1. Go to the Integrations tab in your dashboard.
2. Select Webhook (Zapier / Make / n8n) from the type dropdown.
3. Enter a Name (e.g., "Zapier Lead Sync").
4. Paste your Webhook URL.
5. Optionally set a Signing Secret for HMAC verification (see Security).
6. Click Add Integration.

Zapier Example

1. Create a new Zap with the "Webhooks by Zapier" → Catch Hook trigger.
2. Copy the Zapier webhook URL.
3. Paste it into LeadZap's Webhook URL field.
4. Run a test job on LeadZap — the leads will appear in Zapier.
5. Add actions (Google Sheets, email, CRM, etc.).

Make (Integromat) Example

1. Create a new scenario with a Custom Webhook module.
2. Copy the webhook URL from Make.
3. Paste it into LeadZap's Webhook URL field and run a test job to register the data structure.

HubSpot CRM

Automatically create contacts in your HubSpot CRM for every lead in a completed job.

Setup

1. In HubSpot, go to Settings → Integrations → Private Apps.
2. Create a new Private App with the crm.objects.contacts.write scope.
3. Copy the Access Token.
4. In LeadZap, select HubSpot CRM as the integration type.
5. Paste your access token in the API Key / Token field.
6. Click Add Integration.

What Gets Synced

Pipedrive CRM

Create organisations, persons, and optionally deals in Pipedrive for each lead.

Setup

1. In Pipedrive, go to Settings → Personal preferences → API.
2. Copy your API Token.
3. In LeadZap, select Pipedrive CRM as the integration type.
4. Paste the token in the API Key / Token field.
5. Optionally enter a Pipeline ID to auto-create deals.
6. Click Add Integration.

What Gets Created

1. Organisation — the business (name, address).
2. Person — linked to the org (owner name, email, phone).
3. Deal (optional) — if a Pipeline ID is set, a deal named "LeadZap — {Business Name}" is added to that pipeline.

Webhook Payload Format

When a job completes, the webhook receives a POST request with the following JSON body:

{
  "event": "job.completed",
  "job_id": 42,
  "total_leads": 25,
  "timestamp": "2026-02-16T12:00:00.000Z",
  "leads": [
    {
      "business_name": "Acme Plumbing",
      "industry": "plumbing",
      "city": "Austin",
      "state": "TX",
      "phone": "+15125551234",
      "phone_2": "+15125555678",
      "email": "john@acmeplumbing.com",
      "email_2": "info@acmeplumbing.com",
      "email_3": null,
      "email_verified": 1,
      "email_source": "scraped+icypeas",
      "website": "https://acmeplumbing.com",
      "google_rating": 4.8,
      "google_review_count": 127,
      "owner_name": "John Smith",
      "business_description": "Full-service plumbing...",
      "facebook_url": "https://facebook.com/acmeplumbing",
      "instagram_url": "https://instagram.com/acmeplumbing",
      "linkedin_url": null,
      "twitter_url": null,
      "youtube_url": null,
      "people": [
        { "name": "John Smith", "role": "Owner" },
        { "name": "Jane Doe", "role": "Office Manager" }
      ]
    }
  ]
}

Headers

Security & HMAC Signing

If you set a Signing Secret on your webhook, every payload is signed with HMAC-SHA256. This lets your server verify that the request genuinely came from LeadZap.

How to Verify (Node.js Example)

import crypto from 'crypto';

function verifySignature(body, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// In your webhook handler:
const rawBody = await request.text();
const sig = request.headers.get('X-LeadZap-Signature');
if (!verifySignature(rawBody, sig, YOUR_SECRET)) {
  return new Response('Invalid signature', { status: 401 });
}
const data = JSON.parse(rawBody);

Python Example

import hmac, hashlib

def verify_signature(body: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(), body, hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

Limits & Troubleshooting

Limits

• 10 integrations per user account.
• Webhooks must respond within 30 seconds.
• HubSpot contacts are batched in groups of 100.
• Integrations fire on job completion only (not per-batch).

Troubleshooting