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

const migma = new Migma('YOUR_API_KEY');

const { data, error } = await migma.domains.createManaged({
  prefix: 'yourcompany'
});
{
  "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
​
prefix
string
required

Subdomain prefix (e.g., 'acme' creates acme.migma.email). Lowercase letters, numbers, and hyphens only.

Required string length: 3 - 63
Pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$
​
region
enum<string>
default:us-east-1

AWS SES region for sending

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

Response

Managed domain created

​
success
boolean
required
​
data
object
​
error
string | null