Skip to content

Send test email

Request

Send a test email with intelligent defaults based on domain health.

Features:

  • Supports 3 test modes: basic, standard, full
  • Auto-disables tracking based on test mode
  • Basic spam word detection (not comprehensive scoring)
  • Returns warnings and recommendations
  • Provides next steps for new domains

Test Modes:

  • basic: Disables all tracking regardless of request. Best for new domains.
  • standard: Disables open tracking, enables click tracking. For warming domains.
  • full: Honors your tracking preferences. For established domains.

Best Practice:

  1. Call /api/v1/customer/domains/test-readiness/:domain_id first
  2. Use the recommended test mode
  3. Review warnings before sending
  4. Follow next steps provided in response

Content Analysis: Set analyze_content: true to receive basic spam word warnings.

When HTML is supplied without a text value, the test send derives its plain-text MIME alternative using the same generator as bulk campaign delivery. This keeps test-message MIME structure representative of the production send path.

Note: This endpoint performs only basic spam detection. For comprehensive content scoring with detailed analysis, use POST /api/content-score (subject to tier limits).

Security
ApiKeyAuth
Bodyapplication/jsonrequired
domain_idstring, (uuid)required

Domain ID

fromstring, (email)required

From email address

tostring, (email)required

To email address

subjectstring

Email subject (default "Test Email")

htmlstring

HTML content

textstring

Plain text email body. If omitted when html is provided, a plain-text version is automatically generated from the HTML before sending.

track_opensboolean

Enable open tracking (overridden by test_mode)

track_clicksboolean

Enable click tracking (overridden by test_mode)

test_modestring

Test mode to use (recommended from test-readiness API)

Enum:"basic""standard""full"
analyze_contentboolean

Run basic spam word detection (not full content scoring)

Default:true
curl -i -X POST \
  https://api.mailerlogic.net/api/v1/customer/test-email \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "domain_id": "d1234567-e89b-12d3-a456-426614174000",
    "from": "test@mail.example.com",
    "to": "you@gmail.com",
    "subject": "Test Email",
    "text": "This is a test email.",
    "test_mode": "basic",
    "analyze_content": true
  }'

Responses

Test email queued successfully

Bodyapplication/json
messagestring
emailobject
domain_infoobject
warningsArray of objects
content_analysisobject or null

Basic spam detection results (not comprehensive scoring)

next_stepsArray of strings
Response
{
  "message": "Test email queued successfully",
  "email": {
    "id": "e1234567-e89b-12d3-a456-426614174000",
    "from": "test@mail.example.com",
    "to": "you@gmail.com",
    "subject": "Test Email",
    "domain": "mail.example.com",
    "message_id": "<uuid@mail.example.com>",
    "status": "queued",
    "tracking": { … }
  },
  "domain_info": {
    "age_in_days": 3,
    "has_custom_tracking": false
  },
  "warnings": [
    { … },
    { … }
  ],
  "content_analysis": {
    "basic_check_performed": true,
    "spam_words_found": 0,
    "note": "For detailed content scoring and analysis, use POST /api/content-score (subject to tier limits)"
  },
  "next_steps": [
    "Check your inbox and mark the email as 'Not Spam' if it lands in spam",
    "Send 2-3 more test emails to trusted addresses today",
    "Gradually increase sending volume over the next 2 weeks",
    "Monitor your domain health score regularly",
    "Consider setting up a custom tracking domain to improve deliverability"
  ]
}