# Link Shortening

When creating a lead, you can optionally include a link:

| Field | Description |
| :--- | :--- |
| `link` | A link to send to leads (Aktify does not shorten this link before sending it) |
| `linkToShorten` | A full URL that Aktify will shorten for you |

:::warning
The fields `link` and `linkToShorten` are mutually exclusive — provide one or the other, not both.
:::

## Example

**Request** with `linkToShorten`:

```bash
curl -X POST https://api.aktify.io/api/v1/leads \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "phoneNumber": "(509) 555-1234",
    "region": "CA",
    "firstName": "John",
    "linkToShorten": "https://www.yourcompany.com/landing-page?utm_source=aktify"
  }'
```

**Response**:

```json
{
  "phoneNumber": "(509) 555-1234",
  "region": "CA",
  "firstName": "John",
  "link": "https://links.yourcompany.com/ABC123"
}
```