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

# lead.created

Triggered when a lead is created.

## Event Type

`lead.created`

## Description

This event is fired whenever a new lead is created in your workspace, whether via API, email, SMS, WhatsApp, or portal. Use this event to sync new leads to your CRM or trigger onboarding workflows.

## Payload Structure

<ResponseField name="event" type="string" required>
  The event type: `lead.created`
</ResponseField>

<ResponseField name="data" type="object" required>
  The lead data

  <Expandable title="data">
    <ResponseField name="leadId" type="string" required>
      Unique identifier for the lead
    </ResponseField>

    <ResponseField name="externalId" type="string | null">
      External identifier for the lead (if set)
    </ResponseField>

    <ResponseField name="firstName" type="string | null">
      Lead's first name
    </ResponseField>

    <ResponseField name="middleName" type="string | null">
      Lead's middle name
    </ResponseField>

    <ResponseField name="lastName" type="string | null">
      Lead's last name
    </ResponseField>

    <ResponseField name="phoneNumber" type="string | null">
      Lead's phone number (E.164 format, e.g., `+15551234567`)
    </ResponseField>

    <ResponseField name="email" type="string | null">
      Lead's email address
    </ResponseField>

    <ResponseField name="businessName" type="string | null">
      Lead's business name
    </ResponseField>

    <ResponseField name="website" type="string | null">
      Lead's website URL
    </ResponseField>

    <ResponseField name="source" type="string | null">
      How the lead was created: `inbound-email`, `inbound-sms`, `inbound-whatsapp`, `admin-email`, `portal`, `api`, `http`, `salesforce`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "event": "lead.created",
    "data": {
      "leadId": "50713355-df73-4077-9d84-dcda6da5729c",
      "externalId": "ext-lead-001",
      "firstName": "John",
      "middleName": null,
      "lastName": "Doe",
      "phoneNumber": "+15551234567",
      "email": "john@example.com",
      "businessName": "Acme Inc",
      "website": "https://acme.com",
      "source": "inbound-email"
    }
  }
  ```
</ResponseExample>