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"
}