Skip to main content
POST
https://api.bouncy.ai
/
v1
/
groups
curl -X POST https://api.bouncy.ai/v1/groups \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Campaign 2026",
    "description": "All links for the summer marketing campaign",
    "color": "#FF5733"
  }'

{
  "id": "grp_abc123xyz",
  "name": "Summer Campaign 2026",
  "description": "All links for the summer marketing campaign",
  "color": "#FF5733",
  "linkCount": 0,
  "createdAt": "2026-02-06T12:00:00Z"
}

​
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

​
name
string
required
Name of the groupExample: Summer Campaign 2026
​
description
string
Optional description of the groupExample: All links for the summer marketing campaign
​
color
string
Optional hex color code for visual organizationExample: #FF5733

​
Response

​
id
string
Unique identifier for the group
​
name
string
Group name
​
description
string
Group description
​
color
string
Group color
​
linkCount
number
Number of links in this group (0 for new groups)
​
createdAt
string
ISO 8601 timestamp of creation
curl -X POST https://api.bouncy.ai/v1/groups \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Campaign 2026",
    "description": "All links for the summer marketing campaign",
    "color": "#FF5733"
  }'

{
  "id": "grp_abc123xyz",
  "name": "Summer Campaign 2026",
  "description": "All links for the summer marketing campaign",
  "color": "#FF5733",
  "linkCount": 0,
  "createdAt": "2026-02-06T12:00:00Z"
}