Troubleshoot an SMTP send failure

Pixie CRM guidance. Follow the route for your workspace, check your role and enabled modules, and verify the result before moving on.

Diagnose failed/retried outbox.

What this guide helps you do

Diagnose failed/retried outbox. The workflow below follows the supported application or module flow and does not invent a menu or bypass validation.

Follow these steps

1. Go to the exact navigation path shown above.
2. Select the authorised mailbox, message or configuration record.
3. Complete the fields or action described in this guide.
4. Save or submit once, then verify the resulting status and related record.

Fields and options

This workflow does not expose additional user-entered fields.

Rules and limits

• Check active account and SMTP host/port/auth.
• Rotate, do not reveal stored secret.
• Check attempts/error/next retry.
• Verify TLS/DNS/provider policy.
• Three failed attempts leads failed.

Check it worked

• The requested Mailbox Exchange record is updated through the supported controller and remains attributable to the acting staff member.

Security, audit and troubleshooting checks

• Use the exact authorised account, role and record before saving or sending.
• Verify the saved status and downstream record; a browser success message alone is not sufficient evidence.
• Never expose passwords, API keys, access tokens, protected attachments or raw server paths in support tickets.
• Do not edit module or core database records directly to bypass validation, permissions, migrations or state rules.

Related guides