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 campaign link is confirmed delivered. This is a specialized version of lead.message_delivered that fires when the delivered message contained a campaign link.

{
  "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 ..."
  }
}

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)

---

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"
  }
}

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

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.