Distribution Logs
Where to find it
Sidebar > Distribution > Logs
Distribution Logs
The Logs page is the per-delivery view of your distribution activity. Every DistributionJob is listed here, with its status, the partner involved, the lead, and the time it ran. This is the page you open when something looks wrong and you need to understand exactly what happened.
Where to find it
Sidebar > Distribution > Logs. The page is scoped to your current Entity. Switch Entities using the selector at the top.
Anatomy of a log row
Each row is one distribution job. From left to right:
- Status. Pending, Delivered, Failed, or Cancelled (see below for what each means).
- Lead. Name (or fallback identifier) of the lead being distributed. Click to open the lead drawer.
- Partner. Which partner received it. Empty if no partner matched.
- Profile. Which Distribution Profile the job ran through.
- Time. When the job ran.
Status values
| Status | What it means |
|---|---|
| Delivered | The partner accepted the lead. For webhook delivery, the partner's endpoint returned a 2xx response. For email delivery, the SMTP server accepted the message. |
| Failed | The job ran but could not deliver. Common causes: no partner matched the filter rules, partner endpoint returned an error, partner's cap is full, SMTP rejection. |
| Pending | The job is queued or in flight. Most jobs spend less than a second here. If a job is stuck in Pending for minutes, the queue worker may be down. |
| Cancelled | The job was cancelled after the fact, either by an automation rule or by manual action in the CRM. Refunds and revenue cancellations are recorded here. |
Filters
Three controls narrow the table:
- Search. Free-text search against lead identifier and partner name.
- Status filter. Multi-select. Tick the statuses you want to see. Defaults to all.
- Partner filter. Multi-select. Restrict to a specific set of partners.
The page paginates 20 rows at a time. Page state is preserved as you filter, so you don't lose your place.
Editing a lead from the logs
Click any lead identifier in the table. A side drawer opens with the lead's full record. You can edit fields, change status, add notes, see the activity timeline. Close the drawer to return to the logs.
This is convenient for diagnosing routing problems. If a lead failed to distribute because of a missing field, you can fix the field directly from this page, then re-run the distribution from the lead's activity panel (see How Distribution Works for re-run options).
Common debugging workflows
"Why didn't this lead distribute?"
- Open the logs and search by the lead's name or email.
- Look at the most recent row for that lead.
- Status = Failed. Click into the lead drawer, scroll the activity timeline for a
distribution_eventwith a reason like "no partner matched filter X" or "partner Y rejected: cap full." - No row at all. The lead never triggered distribution. Check whether your trigger automation is enabled and matches the lead's current stage.
"Which leads went to Partner X this week?"
- Tick the Status: Delivered filter.
- Tick the Partner: Partner X filter.
- Read the table. Adjust the date implicitly by scrolling, or use the Analytics page for explicit date ranges.
"Why is Partner Y getting nothing?"
- Filter to Partner: Partner Y with all statuses.
- If you see Failed rows, click in to see the reasons.
- If you see no rows at all, the partner is not matching any routing rule. Open the Routing Rules page and check the filter set assigned to that partner.
Logs vs Analytics
A quick mental map:
- Analytics answers business questions: "how much did we deliver, how much did we earn?"
- Logs answers operational questions: "what happened to this specific lead at this specific time?"
Use the right one for the question you're asking.
Retention
Distribution jobs are retained indefinitely by default. If your account approaches plan storage limits, consult Plans and Pricing for retention overrides.
Related articles
- How Distribution Works
- Distribution Analytics
- Routing Rules
- Lead Detail View. The drawer that opens when you click a lead