Skip to main content

Link Events

Triggered when an outbound SMS message containing a URL is sent to a lead. One event is fired per URL found in the message body.

{
"metadata": {
"apiVersion": "2026-02-09",
"eventType": "lead.link_sent",
"campaignId": "abc456xyz",
"eventTime": "2024-01-28T12:00:00.000Z"
},
"data": {
"phone": "+1234567890",
"externalLeadId": "abc123",
"url": "https://link.akti.fyi/abc123"
}
}
FieldTypeDescription
data.phonestringE.164 formatted phone number
data.externalLeadIdstring?Your external lead ID, if one was provided
data.urlstringThe URL that was included in the message

Triggered when an outbound SMS message containing a URL is confirmed delivered. One event is fired per URL found in the delivered message body.

{
"metadata": {
"apiVersion": "2026-02-09",
"eventType": "lead.link_delivered",
"campaignId": "abc456xyz",
"eventTime": "2024-01-28T12:00:05.000Z"
},
"data": {
"phone": "+1234567890",
"externalLeadId": "abc123",
"message": "Hey John, check out https://link.akti.fyi/abc123 ...",
"url": "https://example.com/destination",
"shortUrl": "https://link.akti.fyi/abc123",
"indicator": "shortUrl"
}
}
FieldTypeDescription
data.phonestringE.164 formatted phone number
data.externalLeadIdstring?Your external lead ID, if one was provided
data.messagestringThe full delivered message body (which includes the link)
data.urlstringThe original destination URL
data.shortUrlstring?The shortened URL, if the link was shortened; otherwise null
data.indicatorstringWhich field this event is about: "shortUrl" or "url". Read data[data.indicator] to get the link as texted to the lead.

Triggered when a lead clicks a tracked (shortened) link.

{
"metadata": {
"apiVersion": "2026-02-09",
"eventType": "lead.link_clicked",
"campaignId": "abc456xyz",
"eventTime": "2024-01-28T12:00:00.000Z"
},
"data": {
"phone": "+1234567890",
"externalLeadId": "abc123",
"url": "https://example.com/destination",
"shortUrl": "https://link.akti.fyi/abc123",
"linkKey": "offer",
"indicator": "shortUrl"
}
}
FieldTypeDescription
data.phonestringE.164 formatted phone number
data.externalLeadIdstring?Your external lead ID, if one was provided
data.urlstringThe original destination URL
data.shortUrlstringThe shortened URL that was clicked
data.linkKeystring?The key of the clicked link, if it was submitted in linksToShorten. Omitted for links submitted in linkToShorten
data.indicatorstringAlways "shortUrl" for click events, since only shortened links are tracked.
note

Repeated clicks within a 30-second window are deduplicated — you will receive at most one event per 30-second period for the same link.