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"]
  }'

{
  "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"
  }
}

​
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"]
  }'

{
  "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"
  }
}