Skip to main content
POST
https://api.bouncy.ai
/
v1
/
domains
curl -X POST https://api.bouncy.ai/v1/domains \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "go.example.com",
    "isDefault": true
  }'
{
  "id": "dom_abc123xyz",
  "domain": "go.example.com",
  "verified": false,
  "isDefault": true,
  "dnsRecords": {
    "type": "CNAME",
    "host": "go",
    "value": "cname.bouncy.ai"
  },
  "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

domain
string
required
The custom domain to connect (without protocol)Example: go.example.com
isDefault
boolean
Whether to make this your default domain for new linksDefault: false
After connecting a domain, you must verify DNS records before it can be used. See the Verify Domain endpoint.

Response

id
string
Unique identifier for the domain
domain
string
The connected domain name
verified
boolean
Whether the domain is verified (will be false initially)
isDefault
boolean
Whether this is your default domain
dnsRecords
object
DNS records that need to be configured
createdAt
string
ISO 8601 timestamp of creation
curl -X POST https://api.bouncy.ai/v1/domains \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "go.example.com",
    "isDefault": true
  }'
{
  "id": "dom_abc123xyz",
  "domain": "go.example.com",
  "verified": false,
  "isDefault": true,
  "dnsRecords": {
    "type": "CNAME",
    "host": "go",
    "value": "cname.bouncy.ai"
  },
  "createdAt": "2026-02-06T12:00:00Z"
}