Skip to main content
POST
https://api.bouncy.ai
/
v1
/
websites
curl -X POST https://api.bouncy.ai/v1/websites \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "johndoe",
    "title": "John Doe - Links",
    "description": "Digital Creator | Follow my socials",
    "template": "bounce",
    "theme": {
      "backgroundColor": "#ffffff",
      "textColor": "#000000",
      "buttonColor": "#084c58"
    },
    "links": [
      {
        "title": "My Website",
        "url": "https://johndoe.com",
        "icon": "globe"
      },
      {
        "title": "YouTube Channel",
        "url": "https://youtube.com/@johndoe",
        "icon": "youtube"
      }
    ],
    "socialLinks": {
      "twitter": "johndoe",
      "instagram": "johndoe"
    }
  }'

{
  "id": "web_abc123xyz",
  "slug": "johndoe",
  "url": "https://bouncy.link/johndoe",
  "title": "John Doe - Links",
  "description": "Digital Creator | Follow my socials",
  "template": "bounce",
  "createdAt": "2026-02-06T12:00:00Z"
}
Complex Customization AvailableWebsite creation has many advanced parameters for design and customization that aren’t fully documented here.Need help? Create a website using the Bouncy.ai dashboard, then contact support - we’ll export the exact API calls for you to duplicate it programmatically.

​
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

​
slug
string
required
URL slug for the websiteExample: myprofile Result: bouncy.link/myprofile
​
title
string
required
Page titleExample: John Doe - Links
​
description
string
Page description/bioExample: Digital Creator | Follow my socials
​
template
string
Template style to useOptions: bounce, simple, deeplink, spotlight, personal Default: bounce
​
theme
object
Theme configuration
​
links
array
Array of link objects to display
​
profileImage
string
URL to profile imageExample: https://example.com/avatar.jpg
​
socialLinks
object
Social media links

​
Response

​
id
string
Unique website ID
​
slug
string
URL slug
​
url
string
Full URL to the websiteExample: https://bouncy.link/myprofile
​
title
string
Page title
​
template
string
Template being used
​
createdAt
string
ISO 8601 timestamp
curl -X POST https://api.bouncy.ai/v1/websites \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "johndoe",
    "title": "John Doe - Links",
    "description": "Digital Creator | Follow my socials",
    "template": "bounce",
    "theme": {
      "backgroundColor": "#ffffff",
      "textColor": "#000000",
      "buttonColor": "#084c58"
    },
    "links": [
      {
        "title": "My Website",
        "url": "https://johndoe.com",
        "icon": "globe"
      },
      {
        "title": "YouTube Channel",
        "url": "https://youtube.com/@johndoe",
        "icon": "youtube"
      }
    ],
    "socialLinks": {
      "twitter": "johndoe",
      "instagram": "johndoe"
    }
  }'

{
  "id": "web_abc123xyz",
  "slug": "johndoe",
  "url": "https://bouncy.link/johndoe",
  "title": "John Doe - Links",
  "description": "Digital Creator | Follow my socials",
  "template": "bounce",
  "createdAt": "2026-02-06T12:00:00Z"
}