Guides

Short links and clicks

Shorten the links in a message, one per recipient, and see who clicked.

Send with "shorten_links": true and every http:// or https:// address in the text becomes a short one, unique to that message: BASE/r/aB3dE9x. Shorter links leave room for text, and because each recipient gets their own, you can see who clicked.

Request body

{
  "to": "+447700900123",
  "from": "YourBrand",
  "body": "Your order #4821 has shipped: https://shop.example.com/o/4821",
  "shorten_links": true
}

The text is shortened before its parts are counted, so you pay for the short version.
Each link in the text gets its own code, even the same address twice.
Punctuation right after a link, such as a full stop, stays outside it.
A visit is redirected to your address at once.

Clicks#

GET /v1/messages/{id} lists the message's links with their clicks and the first and last click time. The console shows the same per message and per campaign.

Link previews and automated visits are left out, so the counts reflect people opening the link. clicks counts visits, not people: a recipient who opens the link twice counts twice.

When your data retention erases a message's text, its links stop working (they answer “This link has expired.”), but their counts stay.