Skip to main content
POST
/
v1
/
links
curl -X POST https://api.bouncy.ai/v1/links \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/summer-sale",
    "slug": "summer",
    "title": "Summer Sale 2026",
    "description": "50% off everything",
    "tags": ["marketing", "sale"]
  }'

const response = await fetch('https://api.bouncy.ai/v1/links', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com/summer-sale',
    slug: 'summer',
    title: 'Summer Sale 2026',
    description: '50% off everything',
    tags: ['marketing', 'sale']
  })
});

const { data: link } = await response.json();
console.log(link.url);

import requests

response = requests.post(
    'https://api.bouncy.ai/v1/links',
    headers={
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'url': 'https://example.com/summer-sale',
        'slug': 'summer',
        'title': 'Summer Sale 2026',
        'description': '50% off everything',
        'tags': ['marketing', 'sale']
    }
)

link = response.json()['data']
print(link['url'])

{
  "success": true,
  "data": {
    "id": "summer",
    "url": "https://bouncy.ai/summer",
    "slug": "summer",
    "destination": "https://example.com/summer-sale",
    "domain": "bouncy.ai",
    "title": "Summer Sale 2026",
    "description": "50% off everything",
    "tags": ["marketing", "sale"],
    "isActive": true,
    "createdAt": "2026-02-06T12:00:00Z"
  }
}

{
  "error": "Missing custom slug"
}

{
  "error": "Custom slug or domain already taken"
}

​
Request

​
Headers

​
Content-Type
string
required
Must be application/json

​
Body

​
url
string
required
The destination URL where the short link should redirect. Must be a valid HTTP or HTTPS URL.Example: https://example.com/my-page
​
slug
string
required
Custom slug for the short URL. Must be unique and contain only lowercase letters, numbers, and hyphens.Example: summer-sale
​
title
string
Title for SEO and social media sharingExample: Summer Sale 2026
​
description
string
Description for SEO and social media cardsExample: Get 50% off all products this summer
​
tags
array
Array of tags for organizing linksExample: ["marketing", "summer", "instagram"]
​
domain
string
Domain to use for the short URL. Can be a system domain (e.g., bouncy.link, mybouncy.link) or a custom domain verified in your account.Example: bouncy.ai Default: bouncy.ai
​
groupId
string
ID of the group to add this link toExample: grp_abc123

​
Response

​
success
boolean
Whether the operation succeeded
​
data
object
The created link object
curl -X POST https://api.bouncy.ai/v1/links \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/summer-sale",
    "slug": "summer",
    "title": "Summer Sale 2026",
    "description": "50% off everything",
    "tags": ["marketing", "sale"]
  }'

const response = await fetch('https://api.bouncy.ai/v1/links', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com/summer-sale',
    slug: 'summer',
    title: 'Summer Sale 2026',
    description: '50% off everything',
    tags: ['marketing', 'sale']
  })
});

const { data: link } = await response.json();
console.log(link.url);

import requests

response = requests.post(
    'https://api.bouncy.ai/v1/links',
    headers={
        'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'url': 'https://example.com/summer-sale',
        'slug': 'summer',
        'title': 'Summer Sale 2026',
        'description': '50% off everything',
        'tags': ['marketing', 'sale']
    }
)

link = response.json()['data']
print(link['url'])

{
  "success": true,
  "data": {
    "id": "summer",
    "url": "https://bouncy.ai/summer",
    "slug": "summer",
    "destination": "https://example.com/summer-sale",
    "domain": "bouncy.ai",
    "title": "Summer Sale 2026",
    "description": "50% off everything",
    "tags": ["marketing", "sale"],
    "isActive": true,
    "createdAt": "2026-02-06T12:00:00Z"
  }
}

{
  "error": "Missing custom slug"
}

{
  "error": "Custom slug or domain already taken"
}