Skip to main content
POST
/
v1
/
short-links
Create a short link
curl --request POST \
  --url https://api.wavix.com/v1/short-links \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "link": "https://your-site.com/long-url",
  "expiration_time": "2023-07-19T18:18:34.235Z",
  "fallback_url": "https://examples.com/fallback",
  "phone": "15155982927",
  "utm_campaign": "summer_promo"
}
'
{
  "short_link": "https://wx.com/hd82Jhs21"
}

Authorizations

​
Authorization
string
header
required

Wavix API key. Pass as Authorization: Bearer <api_key>. Keys support per-resource scopes (none / read / write). See Restricted keys and scopes.

Body

application/json

Short link configuration.

​
link
string
required

Target URL to shorten.

Example:

"https://your-site.com/long-url"

​
expiration_time
string<date-time>

Expiration date and time in ISO 8601 format.

Example:

"2023-07-19T18:18:34.235Z"

​
fallback_url
string

Fallback URL for expired or invalid links.

Example:

"https://examples.com/fallback"

​
phone
string

Phone number for the short link.

Example:

"15155982927"

​
utm_campaign
string

UTM campaign name for tracking insights.

Example:

"summer_promo"

Response

Short link created.

​
short_link
string
required

Generated short URL.

Example:

"https://wx.com/hd82Jhs21"