API Test: Domain Creation

Test POST /accounts/domains/ endpoint with optional client_email parameter

v1.8.2-alpha.3 • Organization API Key Required
API Request
Fill in the form to test domain creation with optional client user

Organization-scoped API key (X-Serendipity-API-Key header)

Domain hostname (auto-fills other fields)

If provided, creates client_user account scoped to this domain

If "WordPress" selected, auto-generates WordPress plugin API key

Creates vectors.domain.com Custom Hostname and returns all DNS records (adds 3-4 seconds)

API Documentation
Endpoint specification and examples
Endpoint
POST /accounts/domains/
Authentication
X-Serendipity-API-Key: sk_org_...
Parameters
hostRequired
registrable_domainOptional
canonical_hostOptional
scopeOptional
client_emailNEW v1.8.2-alpha.2
cms_platformNEW v1.8.2-alpha.3
Example cURL
curl -X POST http://localhost:8086/accounts/domains/ \
  -H "Content-Type: application/json" \
  -H "X-Serendipity-API-Key: sk_org_..." \
  -d '{
    "host": "example.com",
    "registrable_domain": "example.com",
    "canonical_host": "example.com",
    "scope": "registrable",
    "client_email": "owner@example.com"
  }'
Expected Response Fields
  • id - Domain UUID
  • host - Domain hostname
  • verification_status - pending/verified/failed
  • jwks_url - JWKS endpoint URL
  • created_at - ISO timestamp
  • message - Success message
  • client_user - Client user metadata (if email provided)
  • dns_instructions - DNS setup guide (v1.8.2-alpha.2)
  • wordpress - WordPress API key (if cms_platform='wordpress')
✅ v1.8.1-alpha.5: Reseller system
✅ v1.8.1-alpha.8: Impersonation
✅ v1.8.2-alpha.2: Domain + client in one call
🆕 v1.8.2-alpha.3: Auto WordPress integration