Zip Code Filtering
Route leads to buyers based on zip code coverage in Lead Distro AI. Set service area filters, multi-zip buyer territories, and fallback rules for leads outside covered zones in any lead distribution campaign.
Last updated:
Overview
You can route leads to specific buyers based on zip codes. This lets each buyer only receive leads from the areas they service.
Step 1: Add Zip Code to Your Field Mapping
- Go to your Campaign and open the Field Mapping section.
- Make sure Zip Code is included as a mapped field.
- Click Edit on the zip code field to set the format (e.g., US 5-digit only).
- Click Save.
Setting the format to US 5-digit only normalizes zip codes and prevents mismatches from extra digits or formatting differences.
Step 2: Add Zip Code Filters to a Buyer
- Go to the Overview tab for your campaign.
- Find the buyer you want to configure and click Edit.
- Under Lead Filters, select Zip Code.
- Set the condition to In List.
- Paste in the list of zip codes this buyer should receive.
- Click Save Changes.
Now any leads that come in matching those zip codes will be distributed to that buyer.
Step 3: Duplicate for Additional Buyers
To quickly set up another buyer with a different zip code list, click Duplicate on the buyer you just configured. Then update the zip code list with the new buyer's service area and click Save Changes.
How It Works
- When a lead is ingested, the zip code field is checked against each buyer's filter.
- Only buyers whose zip code list includes the lead's zip code will be eligible to receive it.
- This works with all distribution methods — Round Robin, Weighted, Priority, and Ping-Post.
You can combine zip code filters with other lead filters (like state or custom fields) for more precise routing. Each buyer can have their own unique zip code list.
Frequently Asked Questions
How many zip codes can I put in a buyer's filter list?
Practical limit is around 10,000 zip codes per buyer filter — well beyond what most agencies need (the US has ~42,000 zip codes total). If you need broader coverage, switch to a state filter plus an exclude zip list to carve out gaps, rather than enumerating every included zip. Paste lists are auto-deduplicated and normalized to the format set in your field mapping.
Can a buyer cover multiple states with a single zip filter?
Yes. The zip filter doesn't care about state boundaries — paste any mix of zips from any states. Use this when a buyer's service area follows market geography (a metro area that crosses state lines) rather than state lines. For state-aligned coverage, combine a state filter (which is faster to maintain) with optional zip exclusions for sub-state gaps.
How do zip filters combine with state filters and custom field filters?
Filters compose with AND logic. A lead must pass every active filter for the buyer to be eligible. Example: buyer with
state IN [TX, OK] AND zip IN [75001, 75002, ...] AND case_type == auto_accident only receives leads matching all three. Build complex AND/OR groups in the buyer filter UI for branching logic (e.g., zip set A AND case_type X, OR zip set B AND case_type Y).What happens to a lead whose zip code doesn't match any buyer?
The lead is marked
UNMATCHED and held in the dashboard for review. You can manually route it to a buyer, archive it, or set up a fallback automation that sends UNMATCHED leads to a default buyer (e.g., a buyer with no zip filter at all that accepts any leftover). UNMATCHED leads don't generate revenue but also don't generate cost — they're suspended until you take action.Does the zip filter support partial matching (e.g., first 3 digits)?
Not directly — the filter expects full zip codes (5-digit US or full international format). For prefix-based routing (e.g., 'all zips starting with 750'), expand the prefix into the full set of zips in your filter list, or use a custom field with a transform that extracts the prefix and route on that. The Phone Formatter and Date Formatter transforms have a pattern for this; ask support for help if you need it.
Can I use zip code filtering with international leads?
Yes, but the format must match your field mapping setup. Set the zip field's format to International (any-format) rather than US 5-digit, then paste UK postcodes, Canadian postal codes, AU postcodes, etc. State filters work alongside if your lead carries a province or region field, but state-by-zip lookup is US-only.
How fast is the zip filter check?
Sub-millisecond per buyer. Filters run in memory at the time of distribution — even buyers with 10,000-zip lists add no perceptible latency. Routing latency end-to-end (ingest API → distributed to buyer's webhook) stays under 500ms for typical campaign configs, regardless of how many buyers or how many zip-filter entries are evaluated.
Related Articles
Buyer Basics
Manage buyers in Lead Distro AI: delivery methods, lead caps, pricing, state and field filters, white-label buyer portals, and real-time acceptance rules for every buyer in your lead operation.
Delivery Methods
Lead Distro AI buyer delivery methods — Webhook (JSON POST), Email, Google Sheet. How each works, when to use which, and FAQs for picking the right delivery for each buyer.
State Filters
Route leads to Lead Distro AI buyers based on US state coverage. State allowlists, multi-state buyers, combining with zip and custom filters, and FAQs.
Custom Field Filters & Nested AND/OR
Build buyer filters on custom fields with nested AND/OR group logic. Case-type filters, recency rules, numeric ranges, complex branching, and FAQs for Lead Distro AI.
If you have any questions, send us an email at support@leaddistro.ai