Reference · Your page
POST/short-links
Make a short link
Make a short link (https://vessero.com/go/…) that sends people on to any web address and counts the clicks by day, country and where they came from. The ending is random; a chosen one (slug) needs the Plus plan or above. Below Plus, 20 short links can be on at once. rules send some people elsewhere by device or country — an iPhone to the App Store, Android to Google Play — on the Plus plan and up. Free: it costs no credits.
- Key needs
create· Make things and spend credits- Spends
- Nothing
- Answers
- Data
Request
curl -X POST https://vessero.com/api/v1/short-links \ -H "Authorization: Bearer $VESSERO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/summer", "title": "Summer sale" }'
Body
- urlstringrequiredWhere it sends people: an http or https address.
- titlestringA name for the person’s own list.
- slugstringAn ending of their choosing, e.g. summer-drop (Plus plan and up).
- rulesobject[] · up to 6Some visitors sent elsewhere, the first rule that fits winning; everyone else goes to the link’s own address. [] takes them all off. Plus plan and up.
- devicestringSend visitors on this device: ios (iPhone and iPad), android (Android), phone (Any phone or tablet), computer (A computer).
iosandroidphonecomputer - countriesstring[] · up to 30Or send visitors in these countries, as two-letter codes (NG, GB, US).
- urlstringrequiredWhere those visitors go.
- devicestringSend visitors on this device: ios (iPhone and iPad), android (Android), phone (Any phone or tablet), computer (A computer).
Answers
- 200okWhat it did, as data.
- 400invalid_requestA field is missing or not accepted: see details.
- 404not_foundNot found on this account.
- 403feature_unavailableThe studio this needs is switched off for the account right now.