DitLead
Learn Center/Troubleshooting and FAQs/Why did my mailbox connection fail?
troubleshooting

Why did my mailbox connection fail?

Fix common provider, SMTP, IMAP, OAuth, and app-password issues.

6 min read

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.

Why did my mailbox connection fail?: Affected object
Why did my mailbox connection fail?
Check 2

Read the visible state

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

Why did my mailbox connection fail?: Visible status
Why did my mailbox connection fail?
Check 3

Check the common causes

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

Why did my mailbox connection fail?: Common causes
Why did my mailbox connection fail?
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.

Why did my mailbox connection fail?: Retest state
Why did my mailbox connection fail?

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 why did my mailbox connection fail??

Use this guide when you need to understand or complete this workflow inside Troubleshooting and FAQs. 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.

Need a fix?Troubleshoot the workflow step by step

Most issues come from permissions, missing setup, disconnected accounts, invalid data, or blocked jobs.

Open troubleshooting
See it in the productExplore the DitLead platform