Troubleshoot agent runs

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 agent runs: Affected object — Troubleshoot agent runs

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 agent runs: Visible status — Troubleshoot agent runs

Check 3

Check the common causes

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

Troubleshoot agent runs: Common causes — Troubleshoot agent runs

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 agent runs: Retest state — Troubleshoot agent runs

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 agent runs?

Use this guide when you need to understand or complete this workflow inside AI agents and automation. 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 productExplore AI Agents