We support URL shortening for both SMS and SMS Campaign, making it easier to craft a more digestible message for your recipients and also allowing you to save characters in your messages.
Some limitations to be aware of are:
http:// or https://) and a valid domain (e.g., example.com).google.com (does not contain a valid protocol)www.google.com (does not contain a valid protocol)https://examplecom (does not contain a valid domain)For SMS messages, URL shortening automatically detects and replaces one URL in each message with a shortened link in the format smsu.io/xxxxxx. The xxxxxx placeholder represents a unique six-character alphanumeric string that is generated for each recipient during the actual sending process.
You should use this endpoint if you wish to send out a link that is specific to the recipient, such as order tracking links, or customised feedback forms.
To use short URLs on SMS sending, refer here.
We support URL shortening and subsequent link tracking within SMS campaigns.
When using the short URL functionality in SMS Campaign, all recipients will receive a shortened link in the format smsu.io/xxxxx. The xxxxx placeholder represents a unique five-character alphanumeric string that is generated for each recipient during the actual sending process.
You should use this endpoint if you're sending out the same link to many recipients and wish to track its engagement such as whether the link was opened.
To use short URLs when sending an SMS campaign, refer here.
Use this endpoint to get the aggregated statistics for a shortened URL. This allows you to track the total number of clicks on the link. You can gather details such as the device type and where it was opened from as well.
Successful response
curl --include \ --header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \ 'https://rest.clicksend.com/v3/short-url/statistics/{source}/{source_id}'
{- "data": [
- {
- "long_url_id": "quick_sms-26d1bc9a-d858-4b93-9368-1f31377a78c5-5908b13f05e7318be49bd1cb3a693d7c",
- "links": {
- "total": 2,
- "opened_unique": 2,
- "opened_total": 5,
- "unopened": 0
}, - "device": [
- {
- "label": "mobile",
- "count": 2
}
], - "os": [
- {
- "label": "android",
- "count": 2
}
], - "browser": [
- {
- "label": "chrome",
- "count": 2
}
], - "country": [
- {
- "label": "AU",
- "count": 2
}
], - "region": [
- {
- "label": "western_australia",
- "count": 2
}
]
}
]
}Use this endpoint to track how individual recipients interact with the link. It returns data from the most recent click, including statistics such as how many times they’ve visited the link and when it was last opened. To use this endpoint, reference the long_url_id provided in the GET /short-url/statistics endpoint.
Successful response
curl --include \ --header "Authorization: Basic YXBpLXVzZXJuYW1lOmFwaS1wYXNzd29yZA==" \ 'https://rest.clicksend.com/v3/short-url/tracking/{long_url_id}'
{- "total": 500,
- "per_page": 20,
- "current_page_size": 1,
- "data": [
- {
- "open_count": 5,
- "date_opened": 1733981414,
- "user_geo_country": "AU",
- "user_geo_region": "western_australia",
- "user_device": "mobile",
- "user_browser": "chrome",
- "user_os": "android",
- "contact": {
- "contact_id": "224466",
- "first_name": "John",
- "last_name": "Doe",
- "phone_number": "+1234567890"
}
}
]
}