← All docs

Discovery Scheduling & Troubleshooting

Run status meanings, cap behavior, and diagnostics for stable scheduled ingestion.

Use this guide to run Lead Discovery reliably.

Lead Discovery is optional. Satua remains your CRM workspace whether records arrive from CSV, manual entry, lists, or a connected data source.


Setup Checklist

Before enabling a schedule:

  • Data connection status is connected.
  • Provider terms and Satua DPA summary have been acknowledged.
  • ICP is described in the discovery's chat panel.
  • Schedule is set to manual, daily, or weekly.
  • Leads per run is configured (maximum 100 per run — see Why per-run is capped below).
  • Optional per-run cap is configured if your team needs a lower ceiling than 100.
  • Optional monthly cap is configured if your provider quota requires one.
  • Any compliance gate has been acknowledged by a account admin.

Run Status Meanings

StatusMeaning
CompletedRun finished successfully.
PartialRun finished, but fewer unique records were inserted than requested.
RetryingRun is still attempting another pass.
FailedRun did not complete successfully.

A Partial run is usually a signal about your ICP, not a system outage. It often means the ICP is too narrow, available unique records are running low, or your Hunter credits / criteria constrained the run.


What Run History Shows

Run history focuses on operational facts:

  • Requested volume.
  • Inserted volume.
  • Duplicate count.
  • Rejected count.
  • Runtime and trigger.
  • Error message, if any.

Satua's internal quality-control and orchestration details are intentionally not documented here.


Cap Behavior

Satua enforces configured limits before or during execution:

  1. Requested target volume (hard ceiling: 100 per run, platform-wide).
  2. Per-run cap, when set lower than 100.
  3. Monthly remaining volume, when set.
  4. Provider-side quota or plan limits.

If monthly remaining volume is zero, the run is rejected before execution.


Why Per-Run Is Capped At 100

Lead Discovery is tuned for quality over volume. The 100/run ceiling is platform-wide and not negotiable. Beyond that ceiling:

  • Duplicate rates climb sharply as Satua works the same ICP slice repeatedly.
  • Hunter credit consumption scales linearly without proportional unique-record gain.
  • Quality-control passes lose focus, increasing the chance of a partial-completion outcome.

If your team needs more than 100 records per day, use a daily schedule instead of pushing a single run higher. Two daily runs of 100 reliably outperform one large run — Satua gets a fresh dedup snapshot, fresh provider state, and a clean budget per execution.


Troubleshooting Matrix

SymptomLikely causeChecksFix
+ New Discovery is disabledDPA not acknowledged, no connected provider, or all discovery slots are in useLead Discovery page banners and slot countAcknowledge DPA, connect provider, or archive an old discovery
Run blocked before startMonthly cap exhausted or compliance gate pendingDiscovery settings and compliance bannerRaise cap, wait for next month, or acknowledge compliance gate if appropriate
Failed with auth or permission errorHunter API key invalid, revoked, downgraded, or missing the Discover endpointSettings → Data Connections → TestRotate key, restore your Hunter plan, and retest
Repeated Partial runsICP too narrow, market saturated, or Hunter credits lowRun history, duplicate count, inserted count, ICP chatBroaden ICP, lower target volume, or adjust cadence
Want more than 100 leads per dayPer-run cap is 100 platform-wideSchedule and discovery setupSwitch to a daily schedule — two runs of 100 yields better quality than one large batch
High duplicates, low insertsThe current market slice overlaps records already in your accountDuplicate count and existing CRM densityBroaden criteria or steer toward a different segment
Zero-yield but no provider errorOver-filtered ICPTitles, seniority, location, exclusionsRelax one dimension at a time
Provider details hidden on leadsRights prompt not acceptedLead detail -> Provider DetailsAcknowledge only if your account has rights to display those fields

Recommended Operating Cadence

  • Start with manual runs while calibrating a new ICP.
  • Move to weekly once quality is stable.
  • Move to daily only when your team can review and work the volume.
  • Track insert rate, duplicate rate, and rep feedback together.
  • Treat persistent partial runs as an ICP/schedule tuning signal.

Related Guides