Skip to main content
POST
/
v1
/
domains
Node.js SDK
import Migma from 'migma';

const migma = new Migma('YOUR_API_KEY');

const { data, error } = await migma.domains.create({
  domain: 'mail.yourbrand.com'
});
{
  "success": true,
  "data": {
    "_id": "<string>",
    "domain": "<string>",
    "region": "us-east-1",
    "regionName": "<string>",
    "status": "pending",
    "dkimStatus": "SUCCESS",
    "mailFromDomain": "<string>",
    "mailFromStatus": "SUCCESS",
    "dnsRecords": [
      {
        "type": "CNAME",
        "name": "<string>",
        "value": "<string>",
        "priority": 123,
        "status": "pending"
      }
    ],
    "ownershipVerified": true,
    "openTracking": true,
    "clickTracking": true,
    "brandedTracking": true,
    "createdAt": "2023-11-07T05:31:56Z",
    "verifiedAt": "2023-11-07T05:31:56Z",
    "isManagedDomain": true
  },
  "error": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Use 'Authorization: Bearer YOUR_API_KEY' where YOUR_API_KEY is obtained from the Migma dashboard under Settings → API Integration.

Body

application/json
domain
string
required

Domain name (e.g., mail.example.com)

region
enum<string>
default:us-east-1

AWS SES region

Available options:
us-east-1,
eu-west-1

Response

Domain added

success
boolean
required
data
object
error
string | null