# Lead Lifecycle Events

## dnc.created

Triggered when a phone number is added to the Do Not Contact (DNC) list. This can happen when a lead sends a carrier opt-out keyword or an API request is made to DNC a lead. DNCs are company-wide — they apply to all campaigns.

```json
{
  "apiVersion": "2021-08-23",
  "type": "dnc.created",
  "data": {
    "phoneNumber": "+19995550000",
    "dncTimestamp": "2021-11-16T16:00:47.293338",
    "externalLeadId": "lead-12345"
  }
}
```

| Field | Type | Description |
| :--- | :--- | :--- |
| `apiVersion` | string | API version (currently `2021-08-23`) |
| `type` | string | The event type |
| `data.phoneNumber` | string | E.164 formatted phone number |
| `data.dncTimestamp` | string | ISO 8601 timestamp of when the DNC occurred |
| `data.externalLeadId` | string? | Your external lead ID, if one was provided |