Skip to main content

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"
}
}
FieldTypeDescription
data.externalLeadIdstring?Your external lead ID for the lead in the originating campaign
data.phonestringE.164 formatted phone number
data.dncTimestampstringISO 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
}
}
FieldTypeDescription
data.phonestringE.164 formatted phone number
data.externalLeadIdstring?Your external lead ID, if one was provided
data.firstNamestring?Lead's first name
data.lastNamestring?Lead's last name
data.isTestLeadboolean?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
}
}
FieldTypeDescription
data.phonestringE.164 formatted phone number
data.externalLeadIdstring?Your external lead ID, if one was provided
data.lineTypestringThe detected line type — either landline or fixed line
data.firstNamestring?Lead's first name. Only present when a first name was provided.
data.lastNamestring?Lead's last name. Only present when a last name was provided.
data.isTestLeadboolean?Only present when true. Omitted for regular leads.

lead.rejected_prior_dnc​

Triggered when a lead you submit is rejected during posting because its phone number is already on the company's Do Not Contact (DNC) list. The lead is not posted to the campaign and no campaign.lead_created event fires for it. Because lead submissions are accepted (202 Accepted) before this check runs, this event is the only notification that the lead was blocked — use it to reconcile submitted leads that will never be contacted.

{
"metadata": {
"apiVersion": "2026-02-09",
"eventType": "lead.rejected_prior_dnc",
"campaignId": "abc456xyz",
"eventTime": "2024-01-28T12:00:00.000Z"
},
"data": {
"phone": "+1234567890",
"externalLeadId": "abc123",
"dncCreatedAt": "2023-11-02T09:30:00.000Z",
"firstName": "John",
"lastName": "Doe",
"isTestLead": true
}
}
FieldTypeDescription
data.phonestringE.164 formatted phone number
data.externalLeadIdstring?Your external lead ID, if one was provided
data.dncCreatedAtstring?ISO 8601 timestamp of when the phone number was originally added to the DNC list
data.firstNamestring?Lead's first name. Only present when a first name was provided.
data.lastNamestring?Lead's last name. Only present when a last name was provided.
data.isTestLeadboolean?Only present when true. Omitted for regular leads.

lead.not_interested​

Triggered when a lead replies that they are not interested (for example, they already have the product, chose a competitor, or are not eligible) and Aktify stops scheduled outreach to them.

Unlike dnc.created, this does not add the lead to the Do Not Contact list: the lead can still reply and keep talking with the agent. The event fires once, when the lead first moves to not interested. Later not-interested replies from the same lead do not fire it again.

{
"metadata": {
"apiVersion": "2026-02-09",
"eventType": "lead.not_interested",
"campaignId": "abc456xyz",
"eventTime": "2024-01-28T12:00:00.000Z"
},
"data": {
"phone": "+1234567890",
"externalLeadId": "abc123",
"message": "No thanks, not interested"
}
}
FieldTypeDescription
data.phonestringE.164 formatted phone number
data.externalLeadIdstring?Your external lead ID, if one was provided
data.messagestringThe lead's reply that was classified as not interested. If the lead sent several messages in quick succession, they are combined, one per line.