> ## Documentation Index
> Fetch the complete documentation index at: https://docs.preceptai.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Lead Webhooks

This webhook is called when the lead search or lead enrichment is complete. The payload contains the results of the request.

If your webhook endpoint is unavailable or returns an error, we will retry the request up to 3 times with exponential backoff to ensure you receive the data.

### Webhook Payload Examples

<CodeGroup>
  ```json Standard Enrichment theme={null}
  {
    "enrichment_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "name": "Q3 Lead List",
    "status": "completed",
    "results": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "company_name": "Acme Corp",
        "summary": "John Doe is a Senior Software Engineer at Acme Corp with 10 years of experience...",
        "top_problems": "Scaling distributed systems, reducing latency...",
        "internal_strategic_initiatives": "Migrating to microservices, improving CI/CD...",
        "public_appearances": "Keynote speaker at TechConf 2023...",
        "enrich_email": "john.doe@example.com",
        "enrich_phone": "+1234567890",
        "custom_data": {
          "contact_id": "lead_123"
        }
      }
    ],
    "cost": {
      "credits": 22
    }
  }
  ```

  ```json With Generated Outreach Messages theme={null}
  {
    "enrichment_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "name": "Q3 Lead Outreach",
    "status": "completed",
    "results": [
      {
        "first_name": "Sarah",
        "last_name": "Connor",
        "company_name": "Cyberdyne Systems",
        "summary": "Sarah Connor is the Founder & CEO of Cyberdyne Systems...",
        "top_problems": "Inference latency, distributed agent orchestration...",
        "internal_strategic_initiatives": "Deploying agentic workflows, expanding US enterprise sales...",
        "enrich_email": "sarah@cyberdyne.io",
        "enrich_phone": "+14155552671",
        "email_subject": "quick thought on inference latency",
        "email_message": "Hi Sarah,\n\nSaw Cyberdyne's focus on autonomous AI workflows. Teams scaling agent clusters often run into high inference latency that spikes compute bills.\n\nWe helped Apex cut inference delays by 42% while trimming AWS GPU costs.\n\nOpen to seeing how we solved it?\n\nBest,\nAlex",
        "linkedin_message": "Hey Sarah - saw Cyberdyne's work deploying agentic workflows. Teams in your space usually wrestle with inference latency during scaling. Do you mind if I ask how you're handling model latency across clusters?",
        "message_templates": {
          "email": {
            "subject": "quick thought on inference latency",
            "body": "Hi Sarah,\n\nSaw Cyberdyne's focus on autonomous AI workflows. Teams scaling agent clusters often run into high inference latency that spikes compute bills.\n\nWe helped Apex cut inference delays by 42% while trimming AWS GPU costs.\n\nOpen to seeing how we solved it?\n\nBest,\nAlex",
            "problem": "Teams scaling agent clusters often run into high inference latency that spikes compute bills.",
            "impact": "Spiking compute bills and throttled throughput.",
            "proof": "We helped Apex cut inference delays by 42% while trimming AWS GPU costs.",
            "engage": "Open to seeing how we solved it?"
          },
          "linkedin": {
            "message": "Hey Sarah - saw Cyberdyne's work deploying agentic workflows. Teams in your space usually wrestle with inference latency during scaling. Do you mind if I ask how you're handling model latency across clusters?",
            "signal": "Saw Cyberdyne's work deploying agentic workflows.",
            "hypothesis": "Teams in your space usually wrestle with inference latency during scaling.",
            "intro": "Do you mind if I ask how you're handling model latency across clusters?"
          }
        },
        "custom_data": {
          "contact_id": "lead_123"
        }
      }
    ],
    "cost": {
      "credits": 22
    }
  }
  ```

  ```json With Post Search Signal theme={null}
  {
    "enrichment_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "name": "AI Founders Post Search",
    "status": "completed",
    "results": [
      {
        "first_name": "Sarah",
        "last_name": "Connor",
        "linkedinUrl": "https://www.linkedin.com/in/sarah-connor-ai",
        "company_name": "Cyberdyne Systems",
        "summary": "Sarah Connor is the Founder & CEO of Cyberdyne Systems specializing in autonomous AI architectures...",
        "top_problems": "Inference latency, distributed agent orchestration...",
        "internal_strategic_initiatives": "Deploying agentic workflows, expanding US enterprise sales...",
        "public_appearances": "Keynote Speaker at AI Summit 2026...",
        "enrich_email": "sarah@cyberdyne.io",
        "enrich_phone": "+14155552671",
        "post": {
          "url": "https://www.linkedin.com/feed/update/urn:li:activity:7123456789012345678",
          "content": "Excited to announce our open-source release of autonomous multi-agent pipelines for enterprise teams! Check out our benchmarks and let us know what you think.",
          "posted_at": "2026-09-08T14:30:00.000Z",
          "likes_count": 142,
          "comments_count": 28
        },
        "custom_data": {
          "campaign_id": "camp_ai_founders"
        }
      }
    ],
    "cost": {
      "credits": 51
    }
  }
  ```

  ```json With Post Interaction Signal theme={null}
  {
    "enrichment_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "name": "Fintech Leaders Interacting with AI",
    "status": "completed",
    "results": [
      {
        "first_name": "Alex",
        "last_name": "Morgan",
        "linkedinUrl": "https://www.linkedin.com/in/alex-morgan-fintech",
        "company_name": "Apex Capital",
        "summary": "Alex Morgan is VP of Technology at Apex Capital focusing on automated fraud mitigation...",
        "top_problems": "Regulatory compliance, real-time transaction screening...",
        "internal_strategic_initiatives": "Adopting LLMs for AML compliance...",
        "public_appearances": "Speaker at Money20/20...",
        "enrich_email": "alex.morgan@apexcap.com",
        "enrich_phone": "+12125559834",
        "post_activity": "Engaged with post discussing automated fraud detection with LLMs in real-time transaction monitoring",
        "custom_data": {
          "campaign_id": "camp_fintech_aml"
        }
      }
    ],
    "cost": {
      "credits": 51
    }
  }
  ```

  ```json Partial Success theme={null}
  {
    "enrichment_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "name": "Q4 Lead List",
    "status": "completed",
    "results": [
      {
        "first_name": "Jane",
        "last_name": "Smith",
        "company_name": "Precept AI",
        "summary": "Jane Smith leads the marketing team...",
        "top_problems": "Lead generation, brand awareness...",
        "internal_strategic_initiatives": "Launching new product line...",
        "public_appearances": "Panelist at Marketing Summit...",
        "enrich_email": "jane.smith@example.com",
        "enrich_phone": "Not Found",
        "custom_data": {
          "contact_id": "lead_123"
        }
      },
      {
        "error": "Contact not found",
        "customData": {
          "contact_id": "lead_456"
        }
      }
    ],
    "cost": {
      "credits": 12
    }
  }
  ```

  ```json Streaming Progressive (streamingResults: true) theme={null}
  {
    "enrichment_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
    "status": "in_progress",
    "type": "contact_enriched",
    "results": [
      {
        "first_name": "John",
        "last_name": "Doe",
        "company_name": "Acme Corp",
        "company_domain": "acme.com",
        "job_title": "Senior Software Engineer",
        "enrich_email": "john.doe@example.com",
        "enrich_phone": "+1234567890",
        "custom_data": {
          "contact_id": "lead_123"
        }
      }
    ]
  }
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.