Troubleshoot missing development emails
Check application queues, SMTP credentials, TLS settings, workspace usage and retention when test emails do not appear.
When no message appears
- 01Confirm 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.
- 02Verify the exact inbox credential
The credential determines the destination inbox. Account passwords and API keys cannot authenticate over SMTP.
- 03Match the port and TLS mode
Use STARTTLS for 587/2525 or implicit TLS for 465. Do not configure plain SMTP.
- 04Read 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.
- 05Check usage and retention
Free workspaces pause capture after 2,500 monthly messages. Older messages disappear after 7 or 30 days depending on plan.
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.
Updated