# lead.created: a lead was created (/api-reference/webhooks/onLeadCreated)

## Webhook leadCreated

Operation ID: `onLeadCreated`
lead.created: a lead was created
Sent to webhook endpoints subscribed to this event (or to every event). Sent for leads added one at a time: `createLead`, the console's add-lead form, and each lead a connected lead source delivers (Meta lead ads, Google Ads lead forms, lead-source webhooks). It is not sent for spreadsheet imports, campaign lead uploads or campaigns created with leads, nor for leads made automatically for WhatsApp contacts, unknown inbound callers, outbound calls to a new number or do-not-call entries.

### Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `webhook-id` | header | no | The event id (`evt_…`). Same on every retry and redelivery: use it to drop duplicates. Webhook endpoints only. |
| `webhook-timestamp` | header | no | When this attempt was sent, Unix seconds. Webhook endpoints only. |
| `webhook-signature` | header | no | Space-separated `v1,<base64 signature>` values (two for 24 hours after a secret rotation). Webhook endpoints only. |
| `X-Webhook-Id` | header | no | Same on every retry of this delivery (the event id for webhook endpoints). |
| `X-Webhook-Event` | header | no | The event type, for example `call.completed`. |
| `X-Signature-SHA256` | header | no | Hex HMAC-SHA256 of the raw request body only. On webhook endpoints it is a compatibility header, keyed with the whole `whsec_...` string: it covers neither `webhook-id` nor `webhook-timestamp`, so a captured request can be replayed. Verify `webhook-signature` and reject a `webhook-timestamp` more than 5 minutes from your clock instead. On a campaign or agent webhook URL it is the only signature, keyed with that URL's secret (when one is set); the signed body carries `timestamp`, so reject one more than 5 minutes old. |

### Request body

`application/json` (required)

```json
{
  "properties": {
    "apiVersion": {
      "const": "v1",
      "type": "string"
    },
    "createdAt": {
      "description": "When the event happened, ISO 8601 UTC.",
      "format": "date-time",
      "type": "string"
    },
    "data": {
      "properties": {
        "assignedToUserId": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "callStatus": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "company": {
          "type": "string"
        },
        "createdAt": {
          "anyOf": [
            {
              "description": "ISO 8601 timestamp, UTC.",
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "customFields": {
          "additionalProperties": true,
          "description": "Custom field values (text, numbers, booleans or lists). Sensitive and archived fields are left out.",
          "properties": {},
          "type": "object"
        },
        "email": {
          "type": "string"
        },
        "externalId": {
          "anyOf": [
            {
              "description": "Your ID for this lead, when you sent one.",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "id": {
          "format": "uuid",
          "type": "string"
        },
        "leadSourceId": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "name": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "tags": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "title": {
          "type": "string"
        },
        "updatedAt": {
          "anyOf": [
            {
              "description": "ISO 8601 timestamp, UTC.",
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id"
      ],
      "type": "object"
    },
    "id": {
      "description": "Event id, `evt_` and 32 hex characters. Same on retries and redeliveries.",
      "type": "string"
    },
    "type": {
      "const": "lead.created",
      "type": "string"
    }
  },
  "required": [
    "id",
    "type",
    "apiVersion",
    "createdAt",
    "data"
  ],
  "type": "object"
}
```

### Responses

#### 2XX Received. Anything else is retried.
