Using grades and scores
Route by quality, price by grade, filter your leads list, and pass the grade to buyers in every delivery.
The score and grade aren't just reporting. They're available as fields anywhere you write conditions, as a filter on your leads list, and as merge codes in what you send buyers.
| Field | Type | Values |
|---|---|---|
qualityScore | number | 0-100 |
qualityGrade | text | A, B, C, D |
Both appear in the field picker of every condition builder, alongside the fields your pipeline collects. See How scoring works for what the numbers mean.
Route by quality
Add them to a routing rule's conditions:
qualityGradeis one of A, B — a premium buyer that only takes your best.qualityScoregreater than or equal 55 — a floor, when you'd rather tune a number than a letter.
The classic setup pairs this with tiers: tier 1 takes A and B at a high price, tier 2 has no conditions and catches the rest.
A rule that uses quality makes distribution wait
When any rule in the pipeline references the score or the grade, distribution holds until scoring is done — a few seconds — so the decision is made on a real grade rather than a blank. Pipelines with no quality conditions don't wait.
Price by grade
Price rules use the same fields, so you can bill more for better leads without splitting buyers apart: qualityGrade is one of A, B → $42; qualityGrade equals C → $28; catch-all → $15. First match wins — see Lead pricing.
Filter your leads list
The Grade filter on the leads list is a multi-select: click A and B to see only those. The choice stays in the page URL, so you can bookmark or share "my grade-D leads this week", and the same filter applies to the CSV export.
Pass the grade to buyers
Two merge codes are available in every delivery format — email templates, webhook body templates, SMS text, and as quality_grade / quality_score keys in a buyer's delivery schema:
| Merge code | Value |
|---|---|
{quality_grade} | A, B, C or D |
{quality_score} | 0-100 |
Buyers always receive the A-D letter, including on leads scored under older wording — your buyers' integrations only ever see one vocabulary.
Common questions
A lead has no grade. Why? It was never scored — spam, invalid and duplicate leads are stored without a score. Test leads aren't scored either, which is why quality conditions never match in the test console.
Should I condition on the score or the grade? The grade, for anything you discuss with a buyer ("we sell you A and B"). The score when you want to move the cutoff a few points without renegotiating.
Can a buyer see the score without me sending it? No. It goes out only if you include the merge code in that buyer's delivery format or schema. Many sellers send the grade and keep the number to themselves.
I filtered on grade D and got fewer leads than the dashboard shows. The filter only matches scored leads. Unscored leads (spam, invalid, duplicate) carry no grade and are excluded from every grade filter.