Test SMTP settings

POST

/email/validate

Last modified:2026-10-07 23:38:28

OperationId:ValidateSMTPCredsSendTestEmail

Connects to an SMTP server, logs in, optionally sends a test message, and reports each step. Nothing is stored, so you can check settings before you save them on a reseller or domain. Requires Reseller or Super User scope.

The response is 200 whenever the test ran, with success saying whether it worked and details.stage saying where it stopped. A login failure is never retried without encryption. A request that cannot be tested is a 400. Each connection attempt has 10 seconds by default.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The test ran. success says whether it worked.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/email/validate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "smtp-host": "smtp.example.com",
    "smtp-port": 587,
    "smtp-username": "relay@example.com",
    "smtp-password": "{{smtp_password}}"
}'

Response Example

200 - Login only

{
    "success": true,
    "message": "SMTP connection validated successfully",
    "details": {
        "connection_established": true,
        "authentication_successful": true,
        "tls_enabled": true,
        "smtp_host": "smtp.example.com",
        "smtp_port": 587,
        "connection_time_ms": 412,
        "test_email_sent": false,
        "test_email_error": "",
        "stage": "authenticate",
        "authentication_attempted": true,
        "smtp_username": "relay@example.com",
        "smtp_encryption": "starttls",
        "server_response": [
            {
                "code": "235",
                "message": "2.7.0 Authentication successful"
            }
        ],
        "note": null
    }
}

Modified at 2026-10-07 23:38:28

Play recording

Check email address verification