Developer API Reference POST v1

Bulk Link Creation (POST /api/v1/links/bulk)

Generate up to 500 shortened links in a single atomic batch request.

Updated Yesterday 1 min read Verified
SDK & Request Quickstart Select your language
curl -X POST https://klic.in/api/v1/links/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "https://example.com/target",
    "customSlug": "my-brand-link"
  }'
const response = await fetch('https://klic.in/api/v1/links/bulk', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "destination": "https://example.com/target",
    "customSlug": "my-brand-link"
  })
});
const data = await response.json();
console.log(data);
import requests

url = "https://klic.in/api/v1/links/bulk"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "destination": "https://example.com/target",
    "customSlug": "my-brand-link"
  }

response = requests.post(url, json=payload, headers=headers)
print(response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");

var content = new StringContent(@"{
    ""destination"": ""https://example.com/target"",
    ""customSlug"": ""my-brand-link""
  }", Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://klic.in/api/v1/links/bulk", content);
string result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
<?php
$curl = curl_init();
$payload = json_encode({
    "destination": "https://example.com/target",
    "customSlug": "my-brand-link"
  });

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://klic.in/api/v1/links/bulk',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ]
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	payload := []byte(`{
    "destination": "https://example.com/target",
    "customSlug": "my-brand-link"
  }`)

	req, _ := http.NewRequest("POST", "https://klic.in/api/v1/links/bulk", bytes.NewBuffer(payload))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}
200 OK 18ms application/json
{
  "status": "success",
  "data": {
    "id": "link_9a482b1c",
    "shortUrl": "https://klic.in/launch2026",
    "destination": "https://mybrand.com/launch-promo",
    "domain": "klic.in",
    "clicks": 0,
    "createdAt": "2026-08-20T13:36:12.842Z"
  }
}

Bulk Link Creation

Generate multiple shortened links in a single atomic batch request.

Endpoint

HTTP
POST https://klic.in/api/v1/links/bulk
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters

ParameterTypeRequiredDescription
linksarrayYesArray of up to 500 link creation objects.

HTTP Response Status Codes

{
  "success": true,
  "statusCode": 200,
  "data": {
    "id": "link_89412a8f",
    "shortCode": "summer-2026",
    "shortUrl": "https://klic.in/summer-2026",
    "destination": "https://mybrand.com/summer-collection",
    "clicks": 0,
    "createdAt": "2026-08-20T17:05:00Z"
  }
}
{
  "success": false,
  "statusCode": 400,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The destination URL must be a valid absolute URI (HTTP/HTTPS)."
  }
}
{
  "success": false,
  "statusCode": 401,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid Bearer API token in Authorization header."
  }
}
{
  "success": false,
  "statusCode": 429,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit of 100 requests per second exceeded for your workspace plan."
  }
}