Connect 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

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

Errors

Code	Meaning
`duplicate_record`	Domain already connected to this or another company
`provider_error`	Failed to register domain with email provider

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

​Errors

Workflow

Errors