# 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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.
:::