Copy page
Link Events
lead.link_sent
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"
}
}
| Field | Type | Description |
|---|---|---|
data.phone | string | E.164 formatted phone number |
data.externalLeadId | string? | Your external lead ID, if one was provided |
data.url | string | The URL that was included in the message |
lead.link_delivered
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"
}
}
| 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 full delivered message body (which includes the link) |
data.url | string | The original destination URL |
data.shortUrl | string? | The shortened URL, if the link was shortened; otherwise null |
data.indicator | string | Which field this event is about: "shortUrl" or "url". Read data[data.indicator] to get the link as texted to the lead. |
lead.link_clicked
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"
}
}
| Field | Type | Description |
|---|---|---|
data.phone | string | E.164 formatted phone number |
data.externalLeadId | string? | Your external lead ID, if one was provided |
data.url | string | The original destination URL |
data.shortUrl | string | The shortened URL that was clicked |
data.linkKey | string? | The key of the clicked link, if it was submitted in linksToShorten. Omitted for links submitted in linkToShorten |
data.indicator | string | Always "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.