> ## 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>

    <ResponseField name="tags" type="string[]">
      Tags attached to the lead at creation, or an empty array when no tags were provided
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="actor" type="object | null">
  Workspace user who created this lead. Returns `null` for leads not created by
  a workspace user.

  <Expandable title="actor">
    <ResponseField name="type" type="enum">
      Type of actor
    </ResponseField>

    <ResponseField name="id" type="string">
      Unique identifier for the user
    </ResponseField>

    <ResponseField name="name" type="string | null">
      Name of the user
    </ResponseField>

    <ResponseField name="email" type="string">
      Email address of the user
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "event": "lead.created",
    "actor": {
      "type": "USER",
      "id": "8a1f6c2e-4b7d-4e2a-9c3f-1d5e6f7a8b9c",
      "name": "Jane Doe",
      "email": "jane@acme.com"
    },
    "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",
      "tags": ["VIP", "priority-1"]
    }
  }
  ```
</ResponseExample>