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. The campaignId in the metadata refers to the campaign where the DNC originated.

{
  "metadata": {
    "apiVersion": "2026-02-09",
    "eventType": "dnc.created",
    "campaignId": "abc456xyz",
    "eventTime": "2024-01-28T12:00:00.000Z"
  },
  "data": {
    "externalLeadId": "abc123",
    "phone": "+1234567890",
    "dncTimestamp": "2024-01-28T12:00:00.000Z"
  }
}

Field	Type	Description
data.externalLeadId	string?	Your external lead ID for the lead in the originating campaign
data.phone	string	E.164 formatted phone number
data.dncTimestamp	string	ISO 8601 timestamp of when the DNC occurred

---

campaign.lead_created

Triggered when a new lead is fully processed and posted to a campaign — after validation, cleaning, line type determination, and agent phone assignment are complete. This ensures the lead is confirmed SMS-capable before the notification fires.

{
  "metadata": {
    "apiVersion": "2026-02-09",
    "eventType": "campaign.lead_created",
    "campaignId": "abc456xyz",
    "eventTime": "2024-01-28T12:00:00.000Z"
  },
  "data": {
    "phone": "+1234567890",
    "externalLeadId": "abc123",
    "firstName": "John",
    "lastName": "Doe",
    "isTestLead": true
  }
}

Field	Type	Description
data.phone	string	E.164 formatted phone number
data.externalLeadId	string?	Your external lead ID, if one was provided
data.firstName	string?	Lead's first name
data.lastName	string?	Lead's last name
data.isTestLead	boolean?	Only present when true. Omitted for regular leads.

---

lead.landline_detected

Triggered when a lead you submit is determined to be a landline or fixed line during line type determination. These numbers cannot receive SMS, so the lead is not posted to the campaign's messaging flow and no campaign.lead_created event fires for it. Use this event to reconcile submitted leads that will not be contacted via SMS.

{
  "metadata": {
    "apiVersion": "2026-02-09",
    "eventType": "lead.landline_detected",
    "campaignId": "abc456xyz",
    "eventTime": "2024-01-28T12:00:00.000Z"
  },
  "data": {
    "phone": "+1234567890",
    "externalLeadId": "abc123",
    "lineType": "landline",
    "firstName": "John",
    "lastName": "Doe",
    "isTestLead": true
  }
}

Field	Type	Description
data.phone	string	E.164 formatted phone number
data.externalLeadId	string?	Your external lead ID, if one was provided
data.lineType	string	The detected line type — either landline or fixed line
data.firstName	string?	Lead's first name. Only present when a first name was provided.
data.lastName	string?	Lead's last name. Only present when a last name was provided.
data.isTestLead	boolean?	Only present when true. Omitted for regular leads.