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

Node.jsPHPPython.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY,
  accountId: YOUR_ACCOUNT_ID
});

const domains = await client.sendingDomains.getList();

console.log("Sending domains:", domains);

[
  {
    "id": 1,
    "domain_name": "example.com",
    "dns_verified": true,
    "compliance_status": "verified",
    "created_at": "2025-12-30T13:16:34.913Z",
    "updated_at": "2025-12-30T13:16:34.913Z"
  }
]

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

Node.jsPHPPython.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY,
  accountId: YOUR_ACCOUNT_ID
});

const domain = await client.sendingDomains.create({
  domain_name: "example.com"
});

console.log("Created domain:", domain);

{
  "id": 1,
  "domain_name": "example.com",
  "dns_verified": true,
  "compliance_status": "verified",
  "created_at": "2025-12-30T13:16:34.913Z",
  "updated_at": "2025-12-30T13:16:34.913Z"
}

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}

Node.jsPHPPython.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY,
  accountId: YOUR_ACCOUNT_ID
});

const domainId = 12345;
const domain = await client.sendingDomains.get(domainId);

console.log("Domain details:", domain);

{
  "id": 1,
  "domain_name": "example.com",
  "dns_verified": true,
  "compliance_status": "verified",
  "created_at": "2025-12-30T13:16:34.913Z",
  "updated_at": "2025-12-30T13:16:34.913Z"
}

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}

Node.jsPHPPython.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY,
  accountId: YOUR_ACCOUNT_ID
});

const domainId = 12345;
await client.sendingDomains.delete(domainId);

console.log("Domain deleted successfully");

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

Node.jsPHPPython.NETJavacURL

import { MailtrapClient } from "mailtrap";

const client = new MailtrapClient({
  token: process.env.MAILTRAP_API_KEY,
  accountId: YOUR_ACCOUNT_ID
});

const domainId = 12345;
await client.sendingDomains.sendSetupInstructions(
  domainId,
  "[email protected]"
);

console.log("Setup instructions sent");

No content