Skip to main content
POST
/
v1
/
links
cURL
curl -X POST "https://api.klipl.ink/v1/links" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination_url": "https://example.com/",
    "back_half": "your-link",
    "title": "KlipLink API Guide",
    "domain": "links.your-website.com"
  }'
{
  "success": true,
  "short_url": "https://klipl.ink/your-link",
  "destination_url": "https://example.com/",
  "created_at": "2025-11-06T14:30:00.000Z",
  "clicks": 0,
  "title": "KlipLink API Guide"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
destination_url
string
required

The URL the short link should redirect to.

Example:

"https://example.com/"

back_half
string

Custom slug for the short link. If omitted, one is generated automatically.

Example:

"your-link"

title
string

A human-readable label for the link.

Example:

"KlipLink API Guide"

domain
string

A custom domain to use for the short link. Must be added to your account first.

Example:

"links.your-website.com"

Response

Link created successfully

success
boolean
Example:

true

short_url
string
Example:

"https://klipl.ink/your-link"

destination_url
string
Example:

"https://example.com/"

clicks
integer
Example:

255

created_at
string<date-time>
Example:

"2025-11-06T14:30:00.000Z"

title
string
Example:

"Example Link"