Skip to main content
POST
https://api.bouncy.ai
/
v1
/
links
curl -X POST https://api.bouncy.ai/v1/links \
  -H "X-Api-Key: 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"]
  }'

{
  "id": "link_abc123xyz",
  "shortUrl": "https://bouncy.link/summer",
  "slug": "summer",
  "destination": "https://example.com/summer-sale",
  "title": "Summer Sale 2026",
  "description": "50% off everything",
  "tags": ["marketing", "sale"],
  "domain": "bouncy.link",
  "createdAt": "2026-02-06T12:00:00Z",
  "enabled": true,
  "clicks": 0
}

​
Request

​
Headers

​
X-Api-Key
string
required
Your API key (e.g., bcy_live_pk_YOUR_API_KEY)
​
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
Custom slug for the short URL. Must be unique and contain only lowercase letters, numbers, and hyphens. If not provided, a random slug will be generated.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
Custom domain to use (must be verified in your account)Example: go.yourbrand.com Default: bouncy.link
​
groupId
string
ID of the group to add this link toExample: grp_abc123

​
Response

​
id
string
Unique identifier for the link
​
shortUrl
string
The complete short URL
​
slug
string
The slug portion of the short URL
​
destination
string
The destination URL
​
title
string
Link title
​
description
string
Link description
​
tags
array
Array of tags
​
domain
string
Domain used for the short URL
​
createdAt
string
ISO 8601 timestamp of creation
​
enabled
boolean
Whether the link is active
​
clicks
number
Total click count (0 for new links)
curl -X POST https://api.bouncy.ai/v1/links \
  -H "X-Api-Key: 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"]
  }'

{
  "id": "link_abc123xyz",
  "shortUrl": "https://bouncy.link/summer",
  "slug": "summer",
  "destination": "https://example.com/summer-sale",
  "title": "Summer Sale 2026",
  "description": "50% off everything",
  "tags": ["marketing", "sale"],
  "domain": "bouncy.link",
  "createdAt": "2026-02-06T12:00:00Z",
  "enabled": true,
  "clicks": 0
}