Copy page
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. |
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
}
}
| Field | Type | Description |
|---|---|---|
data.phone | string | E.164 formatted phone number |
data.externalLeadId | string? | Your external lead ID, if one was provided |
data.dncCreatedAt | string? | ISO 8601 timestamp of when the phone number was originally added to the DNC list |
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. |
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"
}
}
| Field | Type | Description |
|---|---|---|
data.phone | string | E.164 formatted phone number |
data.externalLeadId | string? | Your external lead ID, if one was provided |
data.message | string | The lead's reply that was classified as not interested. If the lead sent several messages in quick succession, they are combined, one per line. |