curl -X POST https://api.bouncy.ai/v1/groups \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Summer Campaign 2026"}'
const response = await fetch('https://api.bouncy.ai/v1/groups', {
method: 'POST',
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ name: 'Summer Campaign 2026' })
});
const group = await response.json();
console.log(`Created group: ${group.id}`);
import requests
response = requests.post(
'https://api.bouncy.ai/v1/groups',
headers={
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={'name': 'Summer Campaign 2026'}
)
group = response.json()
print(f"Created group: {group['id']}")
{
"id": "grp_abc123xyz",
"name": "Summer Campaign 2026",
"linkCount": 0,
"createdAt": "2026-02-06T12:00:00Z"
}
{
"error": {
"code": "missing_required_field",
"message": "The name field is required",
"field": "name"
}
}
Groups
Create Group
Create a new group to organize your links
POST
/
v1
/
groups
curl -X POST https://api.bouncy.ai/v1/groups \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Summer Campaign 2026"}'
const response = await fetch('https://api.bouncy.ai/v1/groups', {
method: 'POST',
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ name: 'Summer Campaign 2026' })
});
const group = await response.json();
console.log(`Created group: ${group.id}`);
import requests
response = requests.post(
'https://api.bouncy.ai/v1/groups',
headers={
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={'name': 'Summer Campaign 2026'}
)
group = response.json()
print(f"Created group: {group['id']}")
{
"id": "grp_abc123xyz",
"name": "Summer Campaign 2026",
"linkCount": 0,
"createdAt": "2026-02-06T12:00:00Z"
}
{
"error": {
"code": "missing_required_field",
"message": "The name field is required",
"field": "name"
}
}
Request
Headers
Must be
application/jsonBody
Name of the groupExample:
Summer Campaign 2026Response
Unique identifier for the group
Group name
Number of links in this group (0 for new groups)
ISO 8601 timestamp of creation
curl -X POST https://api.bouncy.ai/v1/groups \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Summer Campaign 2026"}'
const response = await fetch('https://api.bouncy.ai/v1/groups', {
method: 'POST',
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ name: 'Summer Campaign 2026' })
});
const group = await response.json();
console.log(`Created group: ${group.id}`);
import requests
response = requests.post(
'https://api.bouncy.ai/v1/groups',
headers={
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY',
'Content-Type': 'application/json'
},
json={'name': 'Summer Campaign 2026'}
)
group = response.json()
print(f"Created group: {group['id']}")
{
"id": "grp_abc123xyz",
"name": "Summer Campaign 2026",
"linkCount": 0,
"createdAt": "2026-02-06T12:00:00Z"
}
{
"error": {
"code": "missing_required_field",
"message": "The name field is required",
"field": "name"
}
}
⌘I