Troubleshoot mailbox connection errors

Before you troubleshoot

Open the affected workspace and note the page, item name, status, and visible error message.
Check whether the problem affects one record, one user, one account, or the whole workspace.
Avoid retrying bulk actions repeatedly until you understand the likely cause.

Checks

Check 1

Identify the affected object

Confirm whether the issue belongs to a campaign, sender, list, contact, agent, integration, workspace setting, or user permission.

Troubleshoot mailbox connection errors: Affected object — Troubleshoot mailbox connection errors

Check 2

Read the visible state

Check status labels, validation messages, warning banners, empty states, recent activity, and any error text before changing settings.

Troubleshoot mailbox connection errors: Visible status — Troubleshoot mailbox connection errors

Check 3

Check the common causes

Most issues come from missing permissions, disconnected accounts, invalid data, exhausted credits, schedule conflicts, or incomplete setup.

Troubleshoot mailbox connection errors: Common causes — Troubleshoot mailbox connection errors

Check 4

Apply one fix and retest

Fix the most likely cause, refresh the page, and retry the smallest safe action. Avoid changing multiple things at once unless the fix requires it.

Troubleshoot mailbox connection errors: Retest state — Troubleshoot mailbox connection errors

After fixing it

Retry the workflow after fixing the likely cause.
If the issue remains, capture the affected workspace, page, item name, status, and any visible error before contacting support.

FAQ

Who should use troubleshoot mailbox connection errors?

Use this guide when you need to understand or complete this workflow inside Email accounts and sending setup. It focuses on the product steps users actually take in DitLead.

What should I check before moving on?

Confirm the saved record, selected audience, connected account, validation state, or result shown in DitLead before using it in another workflow.

Sending readinessCheck accounts before launch

Connect mailboxes, validate SMTP/IMAP, warm up accounts, and choose conservative sending limits.

Prepare accounts

See it in the productSee the Deliverability Suite