Skip to main content
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

Content-Type
string
required
Must be application/json

Body

name
string
required
Name of the groupExample: Summer Campaign 2026

Response

id
string
Unique identifier for the group
name
string
Group name
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 "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"
  }
}