arrow_back All endpoints

SMTP Server Test

POST/api/v1/tools/smtp-test3 credits per callsmtpemailmail-serverstarttlsdeliverabilitytls

Speaks SMTP to the server: connects, reads the banner, sends EHLO, upgrades with STARTTLS where offered, inspects the TLS certificate, and - only when credentials are supplied - verifies that AUTH is accepted. It CANNOT send mail, by design, so it is not usable as a relay. Only ports 25, 465, 587 and 2525 are permitted, and private addresses are refused.

receipt_long
Why 3 credits?

A multi-step protocol session with a TLS handshake, held open for several seconds.

Any HTTP client works. Replace the key with one from your dashboard.

bash
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/smtp-test \
  -H "Authorization: Bearer tb_live_<your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "host": "smtp.example.com",
  "port": 587,
  "encryption": "starttls",
  "username": "postmaster@example.com"
}'

Input

FieldTypeRequiredDefaultDescription
hoststringrequired- Mail server hostname.
portintegeroptional587 25, 465, 587 or 2525.
encryptionstringoptionalstarttls starttls, ssl or none. Port 465 always uses implicit TLS.
usernamestringoptional- Optional. Supplying credentials adds an AUTH check; they are used once and never stored.
passwordstringoptional- Optional, required only alongside username.

Output

FieldTypeDescription
encryptionstringWhat the session ended up using: starttls, implicit-tls or none.
authAttemptedbooleanWhether credentials were supplied.
authSucceededbooleanWhether the server accepted them.
certificateSubjectstringTLS certificate subject.
certificateIssuerstringTLS certificate issuer.
certificateExpiresUtcstringCertificate expiry, UTC.
extensionsarrayEHLO capabilities advertised.
authMechanismsarrayAUTH mechanisms offered.
stepsarrayEach protocol step with its timing and reply.

Try it

Sends a real POST /api/v1/tools/smtp-test from your browser and charges 3 credits to your account.

Sign in to run this endpoint. New accounts start with free credits.