Troubleshoot app connections

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 app connections: Affected object — Troubleshoot app connections

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 app connections: Visible status — Troubleshoot app connections

Check 3

Check the common causes

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

Troubleshoot app connections: Common causes — Troubleshoot app connections

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 app connections: Retest state — Troubleshoot app connections

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 app connections?

Use this guide when you need to understand or complete this workflow inside Apps, integrations, API, and webhooks. 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.

Automate workUse agents where review still matters

Let agents research, enrich, or draft work, then review outputs before they affect your workspace.

Learn agents

See it in the productSee Integrations