> ## Documentation Index
> Fetch the complete documentation index at: https://docs-api.incarts.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom URL links

> Wrap any URL in a trackable Incarts short link

Custom URL links wrap any destination URL in a trackable Incarts short link with QR code support.
Use `retailer: "custom"` with `intent: "custom_url"`.

## Request

```json theme={null}
{
  "projectId": "proj_123",
  "name": "Campaign landing page",
  "publicName": "View the campaign",
  "retailer": "custom",
  "intent": "custom_url",
  "customUrl": "https://www.example.com/landing-page",
  "fallbackUrl": "https://www.example.com/",
  "tracking": {
    "utm": {
      "source": "social",
      "medium": "instagram",
      "campaign": "summer-launch"
    },
    "tags": ["campaign", "social"]
  },
  "metadata": {
    "campaignId": "cmp_456"
  }
}
```

| Field       | Type         | Required | Description                                   |
| ----------- | ------------ | -------- | --------------------------------------------- |
| `customUrl` | string (URI) | Yes      | The destination URL the short link points to. |

All other fields (`tracking`, `metadata`, `fallbackUrl`, `defaultQrCode`) work the same as other link types.

<Card title="Create link endpoint" icon="terminal" href="/api-reference/endpoint/create-link">
  Full schema, request playground, and response codes.
</Card>