Skip to main content
​
domain
string
required
The domain to connect (e.g., mycompany.com or mail.mycompany.com)
curl -X POST https://api.usenaive.ai/v1/domains/connect \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "domain": "mycompany.com" }'

{
  "id": "domain-uuid",
  "domain": "mycompany.com",
  "status": "pending_dns",
  "dns_records": [
    { "type": "MX", "name": "mycompany.com", "value": "feedback-smtp.usenaive.email", "priority": 10 },
    { "type": "TXT", "name": "mycompany.com", "value": "v=spf1 include:usenaive.email ~all" },
    { "type": "CNAME", "name": "naive._domainkey.mycompany.com", "value": "naive.domainkey.example.com" }
  ],
  "hint": "Add these DNS records at your registrar, then call POST /v1/domains/{id}/verify"
}

​
Workflow

  1. Call this endpoint with your domain
  2. Add the returned DNS records at your domain registrar (your registrar)
  3. Wait for DNS propagation (typically 5–60 minutes)
  4. Call POST /v1/domains/:id/verify to trigger verification
  5. Once verified, create inboxes with POST /v1/email/inboxes

​
Errors

CodeMeaning
duplicate_recordDomain already connected to this or another company
provider_errorFailed to register domain with email provider