Sending Domains

Manage verified sending domains

Configure and verify domains for email sending to ensure deliverability.

List sending domains

get

Get all sending domains and their verification status

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

Responses

200

List of sending domains

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

get

/api/accounts/{account_id}/sending_domains

cURLNode.jsPHPPython.NETJava

curl -X GET https://mailtrap.io/api/accounts/{account_id}/sending_domains \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "data": [
    {
      "id": 435,
      "domain_name": "mailtrap.io",
      "demo": false,
      "compliance_status": "compliant",
      "dns_verified": true,
      "dns_verified_at": "2024-12-26T09:40:44.161Z",
      "dns_records": [
        {
          "key": "verification",
          "domain": "ve6wza2rbpe60x7z.mailtrap.io",
          "type": "CNAME",
          "value": "smtp.mailtrap.live",
          "status": "pass",
          "name": "ve6wza2rbpe60x7z"
        },
        {
          "key": "spf",
          "domain": "mailtrap.io",
          "type": "TXT",
          "value": "v=spf1 include:_spf.smtp.mailtrap.live ~all",
          "status": "pass",
          "name": ""
        },
        {
          "key": "dkim1",
          "domain": "rwmt1._domainkey.mailtrap.io",
          "type": "CNAME",
          "value": "rwmt1.dkim.smtp.mailtrap.live",
          "status": "pass",
          "name": "rwmt1._domainkey"
        },
        {
          "key": "dkim2",
          "domain": "rwmt2._domainkey.mailtrap.io",
          "type": "CNAME",
          "value": "rwmt2.dkim.smtp.mailtrap.live",
          "status": "pass",
          "name": "rwmt2._domainkey"
        },
        {
          "key": "dmarc",
          "domain": "_dmarc.mailtrap.io",
          "type": "TXT",
          "value": "v=DMARC1; p=none; rua=mailto:[email protected]; ruf=mailto:[email protected]; rf=afrf; pct=100",
          "status": "pass",
          "name": "_dmarc"
        },
        {
          "key": "link_verification",
          "domain": "mt-link.mailtrap.io",
          "type": "CNAME",
          "value": "t.mailtrap.live",
          "status": "pass",
          "name": "mt-link"
        }
      ],
      "open_tracking_enabled": true,
      "click_tracking_enabled": true,
      "auto_unsubscribe_link_enabled": true,
      "custom_domain_tracking_enabled": true,
      "health_alerts_enabled": true,
      "critical_alerts_enabled": true,
      "alert_recipient_email": "[email protected]",
      "permissions": {
        "can_read": true,
        "can_update": true,
        "can_destroy": true
      }
    }
  ]
}

Create sending domain

post

Create a sending domain for email authentication. After creation, verify the domain by adding DNS records.

Process:

1. Create the domain

2. Add DNS records (SPF, DKIM, DMARC)

3. Verify the records

4. Start sending emails

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

Body

application/json

Responses

200

Sending domain details

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

422

Validation errors

application/json

post

/api/accounts/{account_id}/sending_domains

cURLNode.jsPHPPython.NETJava

curl -X POST https://mailtrap.io/api/accounts/{account_id}/sending_domains \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "sending_domain": {
      "domain_name": "example.com"
    }
  }'

{
  "id": 435,
  "domain_name": "mailtrap.io",
  "demo": false,
  "compliance_status": "compliant",
  "dns_verified": true,
  "dns_verified_at": "2024-12-26T09:40:44.161Z",
  "dns_records": [
    {
      "key": "verification",
      "domain": "ve6wza2rbpe60x7z.mailtrap.io",
      "type": "CNAME",
      "value": "smtp.mailtrap.live",
      "status": "pass",
      "name": "ve6wza2rbpe60x7z"
    },
    {
      "key": "spf",
      "domain": "mailtrap.io",
      "type": "TXT",
      "value": "v=spf1 include:_spf.smtp.mailtrap.live ~all",
      "status": "pass",
      "name": ""
    },
    {
      "key": "dkim1",
      "domain": "rwmt1._domainkey.mailtrap.io",
      "type": "CNAME",
      "value": "rwmt1.dkim.smtp.mailtrap.live",
      "status": "pass",
      "name": "rwmt1._domainkey"
    },
    {
      "key": "dkim2",
      "domain": "rwmt2._domainkey.mailtrap.io",
      "type": "CNAME",
      "value": "rwmt2.dkim.smtp.mailtrap.live",
      "status": "pass",
      "name": "rwmt2._domainkey"
    },
    {
      "key": "dmarc",
      "domain": "_dmarc.mailtrap.io",
      "type": "TXT",
      "value": "v=DMARC1; p=none; rua=mailto:[email protected]; ruf=mailto:[email protected]; rf=afrf; pct=100",
      "status": "pass",
      "name": "_dmarc"
    },
    {
      "key": "link_verification",
      "domain": "mt-link.mailtrap.io",
      "type": "CNAME",
      "value": "t.mailtrap.live",
      "status": "pass",
      "name": "mt-link"
    }
  ],
  "open_tracking_enabled": true,
  "click_tracking_enabled": true,
  "auto_unsubscribe_link_enabled": true,
  "custom_domain_tracking_enabled": true,
  "health_alerts_enabled": true,
  "critical_alerts_enabled": true,
  "alert_recipient_email": "[email protected]",
  "permissions": {
    "can_read": true,
    "can_update": true,
    "can_destroy": true
  }
}

Get sending domain

get

Get details and verification status of a specific sending domain

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

sending_domain_idintegerRequired

Sending domain ID

Example: 1

Responses

200

Sending domain details

application/json

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

404

Resource not found

application/json

get

/api/accounts/{account_id}/sending_domains/{sending_domain_id}

cURLNode.jsPHPPython.NETJava

curl -X GET https://mailtrap.io/api/accounts/{account_id}/sending_domains/{sending_domain_id} \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": 435,
  "domain_name": "mailtrap.io",
  "demo": false,
  "compliance_status": "compliant",
  "dns_verified": true,
  "dns_verified_at": "2024-12-26T09:40:44.161Z",
  "dns_records": [
    {
      "key": "verification",
      "domain": "ve6wza2rbpe60x7z.mailtrap.io",
      "type": "CNAME",
      "value": "smtp.mailtrap.live",
      "status": "pass",
      "name": "ve6wza2rbpe60x7z"
    },
    {
      "key": "spf",
      "domain": "mailtrap.io",
      "type": "TXT",
      "value": "v=spf1 include:_spf.smtp.mailtrap.live ~all",
      "status": "pass",
      "name": ""
    },
    {
      "key": "dkim1",
      "domain": "rwmt1._domainkey.mailtrap.io",
      "type": "CNAME",
      "value": "rwmt1.dkim.smtp.mailtrap.live",
      "status": "pass",
      "name": "rwmt1._domainkey"
    },
    {
      "key": "dkim2",
      "domain": "rwmt2._domainkey.mailtrap.io",
      "type": "CNAME",
      "value": "rwmt2.dkim.smtp.mailtrap.live",
      "status": "pass",
      "name": "rwmt2._domainkey"
    },
    {
      "key": "dmarc",
      "domain": "_dmarc.mailtrap.io",
      "type": "TXT",
      "value": "v=DMARC1; p=none; rua=mailto:[email protected]; ruf=mailto:[email protected]; rf=afrf; pct=100",
      "status": "pass",
      "name": "_dmarc"
    },
    {
      "key": "link_verification",
      "domain": "mt-link.mailtrap.io",
      "type": "CNAME",
      "value": "t.mailtrap.live",
      "status": "pass",
      "name": "mt-link"
    }
  ],
  "open_tracking_enabled": true,
  "click_tracking_enabled": true,
  "auto_unsubscribe_link_enabled": true,
  "custom_domain_tracking_enabled": true,
  "health_alerts_enabled": true,
  "critical_alerts_enabled": true,
  "alert_recipient_email": "[email protected]",
  "permissions": {
    "can_read": true,
    "can_update": true,
    "can_destroy": true
  }
}

Delete sending domain

delete

Remove a sending domain from your account

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

sending_domain_idintegerRequired

Sending domain ID

Example: 1

Responses

204

Domain successfully deleted

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

404

Resource not found

application/json

delete

/api/accounts/{account_id}/sending_domains/{sending_domain_id}

cURLNode.jsPHPPython.NETJava

curl -X DELETE https://mailtrap.io/api/accounts/{account_id}/sending_domains/{sending_domain_id} \
  -H 'Authorization: Bearer YOUR_API_KEY'

No content

Send setup instructions

post

Email DNS configuration instructions for the sending domain

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

sending_domain_idintegerRequired

Sending domain ID

Example: 1

Body

application/json

emailstring · emailRequired

Email address to receive setup instructions

Responses

204

Instructions sent successfully

401

Unauthorized. Check your API credentials.

application/json

403

Forbidden. Verify domain or check permissions.

application/json

404

Resource not found

application/json

422

Validation errors

application/json

post

/api/accounts/{account_id}/sending_domains/{sending_domain_id}/send_setup_instructions

cURLNode.jsPHPPython.NETJava

curl -X POST https://mailtrap.io/api/accounts/{account_id}/sending_domains/{sending_domain_id}/send_setup_instructions \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "[email protected]"
  }'

No content