>_SMTPBoxDOCUMENTATION

Troubleshoot missing development emails

Check application queues, SMTP credentials, TLS settings, workspace usage and retention when test emails do not appear.

13 / DIAGNOSE

When no message appears

  1. 01
    Confirm the application attempted to send

    Check your application's own test output or mail log first. Queued mail may still be waiting for a worker.

  2. 02
    Verify the exact inbox credential

    The credential determines the destination inbox. Account passwords and API keys cannot authenticate over SMTP.

  3. 03
    Match the port and TLS mode

    Use STARTTLS for 587/2525 or implicit TLS for 465. Do not configure plain SMTP.

  4. 04
    Read the complete SMTP response

    Enable temporary mailer debug output in a safe environment, then compare the final response with the error reference above. Never publish passwords in logs.

  5. 05
    Check usage and retention

    Free workspaces pause capture after 2,500 monthly messages. Older messages disappear after 7 or 30 days depending on plan.

NEED A SECOND PAIR OF EYES?

Send useful, safe diagnostic details.

Include the UTC time, SMTP or HTTP status, complete error text, framework, port and TLS mode. Never send an SMTP password, API key or webhook secret.

Contact support →

Updated