Authorization: Bearer <token>. Get it with the sign-in call (POST /api/customer-users/partner-login).code, not the full address. The short address is the address of this server, then /r/, then the code, for example https://link-shortener-api.veloconnect.me/r/autumn-sale. Keep the id as well: you need it to change or delete the link and to read its statistics. There is no call that lists all your links.destinationUrl must be a full http:// or https:// address of at most 2048 characters.customAlias out and the code is 8 random letters and digits. Send customAlias to choose the code yourself: up to 32 Latin letters, digits, - and _. If the code is already taken, the call answers 409.expiresAtUtc must be in the future and maxClicks must be above 0. After the expiry time or the click limit the short address answers 410 and no longer redirects.campaignId and contactId are ids of your own choice, in GUID form. They group links for the campaign and contact statistics calls. campaignImpressions and contactImpressions are the impression counts: how many times the links were sent or shown. You supply them, and the click rate is worked out from them.Idempotency-Key header. If you repeat the same request with the same key, you get the link from the first call again and no second link is made. The same key with a different body answers 409.curl --location 'https://link-shortener-api.veloconnect.me/api/links' \
--header 'Idempotency-Key: order-1042-link' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"destinationUrl": "https://shop.example.com/autumn-sale?utm_source=sms",
"customAlias": "autumn-sale",
"expiresAtUtc": "2026-12-31T20:00:00Z",
"isActive": true,
"maxClicks": 5000,
"campaignId": "b7d4e2a1-93c6-4f08-8a5e-1d2c3b4a5f60",
"metadata": {
"source": "sms",
"segment": "returning-customers"
},
"tags": [
"autumn",
"sms"
],
"campaignImpressions": 12000
}'{
"id": "3f2b8c1e-5d47-4a9b-9c0e-7a1d2e3f4b5c",
"code": "autumn-sale",
"destinationUrl": "https://shop.example.com/autumn-sale?utm_source=sms",
"isCustomAlias": true,
"isActive": true,
"expiresAtUtc": "2026-12-31T20:00:00+00:00",
"maxClicks": 5000,
"campaignId": "b7d4e2a1-93c6-4f08-8a5e-1d2c3b4a5f60",
"contactId": null,
"metadata": {
"source": "sms",
"segment": "returning-customers"
},
"tags": [
"autumn",
"sms"
],
"createdAtUtc": "2026-10-08T09:30:00+00:00",
"updatedAtUtc": "2026-10-08T09:30:00+00:00"
}