Custom Domains
Use your own domain for agent email addresses.
Custom Domains
By default, inboxes use @lumbox.co. You can add your own domain for branded agent emails like bot@yourdomain.com.
Add Domain
POST /v1/domainscurl -X POST https://api.lumbox.co/v1/domains \
-H "X-API-Key: ak_..." \
-H "Content-Type: application/json" \
-d '{"domain": "yourdomain.com"}'Returns DNS records you need to configure:
{
"id": "dom_abc123",
"domain": "yourdomain.com",
"status": "pending",
"dns_records": [
{ "type": "MX", "host": "@", "value": "mx.lumbox.co", "priority": 10 },
{ "type": "TXT", "host": "@", "value": "v=spf1 include:lumbox.co ~all" },
{ "type": "TXT", "host": "lumbox._domainkey", "value": "..." }
]
}Verify Domain
After adding DNS records, verify them:
POST /v1/domains/:id/verifyReturns { "status": "verified" } when all records are correct.
List Domains
GET /v1/domains