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.

{
  "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