Programmatically create smart short links, generate print-ready dynamic QR codes, query real-time analytics, and listen to real-time click webhooks.
All API requests must include your API key in the HTTP Authorization header with the Bearer scheme. You can create and revoke keys anytime in your Dashboard Settings.
curl -X POST https://api.uwuly.com/v1/links \
-H "Authorization: Bearer uwuly_live_abc123..." \
-H "Content-Type: application/json" \
-d '{
"destination": "https://brand.com/special-launch",
"alias": "launch-2026",
"iosTarget": "https://apps.apple.com/app/id123",
"androidTarget": "https://play.google.com/store/apps/details?id=com.app",
"geoTargets": { "GB": "https://brand.co.uk/launch" },
"ogTitle": "Special Launch Event",
"maxClicks": 1000
}'| Field | Type | Description |
|---|---|---|
| destination | string | Required. The destination long URL to shorten. |
| alias | string | Optional. Custom short slug. Auto-generated if omitted. |
| iosTarget | string | Optional. Deep link URL for iOS and iPhone visitors. |
| androidTarget | string | Optional. Deep link URL for Android visitors. |
| geoTargets | object | Optional. Map of 2-letter country codes to localized URLs. |
| maxClicks | number | Optional. Auto-expire link after total clicks threshold. |
curl -X POST https://api.uwuly.com/v1/qr \
-H "Authorization: Bearer uwuly_live_abc123..." \
-H "Content-Type: application/json" \
-d '{
"name": "Flagship Menu Card",
"destination": "https://brand.com/summer-menu",
"colors": {
"foreground": "#2E3A59",
"background": "#FFFFFF"
},
"frame": {
"type": "badge-bottom",
"text": "SCAN FOR MENU"
}
}'When registered events trigger, uwuly sends an HTTP POST request to your endpoint containing a JSON payload with event metadata.
// Example Payload delivered to your endpoint
{
"event": "link.clicked",
"timestamp": "2026-11-04T02:30:00Z",
"data": {
"linkId": "link-12345",
"alias": "launch-2026",
"destination": "https://brand.com/special-launch",
"country": "US"
}
}Generate your live API key in under 10 seconds and start automating your links and QR codes.