Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
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.us-east-1.amazonses.com", "priority": 10 },
    { "type": "TXT", "name": "mycompany.com", "value": "v=spf1 include:amazonses.com ~all" },
    { "type": "CNAME", "name": "resend._domainkey.mycompany.com", "value": "resend.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 (Cloudflare, Namecheap, etc.)
  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