Routing rules
What a routing rule holds — conditions, price, delivery targets, field mapping, tier and weight — and how to edit it.
A routing rule is one buyer inside one pipeline. It answers three questions: when does this buyer get a lead (conditions), how does it receive it (delivery targets and field mapping), and what does it pay (price). Adding a buyer to a pipeline creates a rule; removing it deletes the rule only — the buyer record and its past leads stay.
Click a buyer on the pipeline canvas to open its panel.
When — conditions
Conditions are built over the fields your pipeline collects, plus two system fields available in every pipeline:
| Field | Type | Values |
|---|---|---|
qualityScore | number | 0-100 |
qualityGrade | text | A, B, C, D |
Operators depend on the field type:
| Field type | Operators |
|---|---|
| Text | equals, not equals, contains, starts with, ends with, is one of, is not one of |
| Number | equals, not equals, greater than, greater than or equal, less than, less than or equal, is one of, is not one of |
Conditions sit in groups joined by AND or OR. A rule with no conditions matches every lead — that's what you want for a backfill buyer, and what you must avoid on a premium one.
Using score or grade in a condition makes distribution wait for scoring to finish. See Using grades and scores.
How — delivery targets and field mapping
Delivery targets pick which of the buyer's endpoints this rule fires. Leave it untouched and the rule delivers to all of the buyer's active endpoints. Select a subset to send only to some of them.
Field mapping lines your pipeline's field names up with the field names the buyer's integration expects — zip on your side to postal_code on theirs. Only the fields defined in the buyer's delivery schema are ever sent: a schema field left unmapped goes out empty, and a pipeline field the schema doesn't list is never delivered, whatever it's named.
What — price
A flat price per lead, plus optional conditional price rules. Full resolution order in Lead pricing.
Tier and weight
Under Advanced — tier & weight. Tier sets priority (Tiers and fallback); weight only has an effect when the pipeline is on Weighted distribution, and the panel shows the resulting share of the tier.
Pause and activate
Pause in this pipeline stops the buyer receiving leads here without deleting anything — its conditions, price and mapping are kept. Activate in this pipeline turns it back on. A paused rule is invisible to distribution: it's not "skipped", it's not considered at all.
“Duplicated to this buyer — review before activating”
Duplicating a rule onto a different buyer copies the conditions, price and field mapping, and starts the copy paused with this amber banner. Those three things were written for the original buyer and may not fit the new one — the delivery targets are reset to the new buyer's defaults. Check them, then Save changes or Activate in this pipeline: either action clears the banner. Duplicating onto the same buyer doesn't raise it.
Common questions
Can I change a rule's buyer? Not directly. Duplicate the rule onto the other buyer — that reuses the conditions without rebuilding them — then remove the old one.
Why does my "premium" buyer receive everything? Its rule almost certainly has no conditions. An empty condition set matches every lead.
I removed a buyer from a pipeline. Did I lose its leads? No. Only the rule is deleted. The buyer, its endpoints and every lead already delivered to it are untouched.
Do I have to map every field? Only the ones the buyer's schema defines and you want filled. Mapping isn't a passthrough — a schema field with no mapping is sent empty, and a pipeline field the schema doesn't define never reaches the buyer.