justin/new-site
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat: NPI outreach list pipeline (120k cold-emailable + 236k DirectTrust-later) + doc

Browse source
This commit is contained in:
justin 2026-06-05 01:08:26 -05:00
parent 091ebbd7f9
commit 73e09b12a0
2 changed files with 291 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

34
docs/new-sector-compliance-targets.md
View file

@ -477,3 +477,37 @@ of endpoint emails, (b) domain-infer + free-SMTP-verify the rest, (c) fall back
phone/fax/mail for non-matches. This recovers a real email channel for a
meaningful chunk of the 217,968 overdue-revalidation targets at **zero vendor
cost**, and we verify deliverability ourselves since port 25 + MX both work here.
---
## 9. NPI Outreach Pipeline — BUILT & RUN (`scripts/build_npi_outreach_lists.py`)
A reusable pipeline that joins the free NPPES endpoint emails to the CMS
revalidation list and cross-flags LEIE + opt-out. Run against live data:
### Verified output (session date)
| Segment | Rows | Use |
|---|---|---|
| **All cold-emailable NPIs** | **120,408** | broad Provider Compliance Bundle campaign — START HERE |
| ↳ of which overdue revalidation | 1,909 | hottest: lead with the $399 revalidation hook |
| ↳ of which upcoming revalidation | 500 | "due soon" pre-emptive offer |
| ↳ no current reval flag | 117,999 | general compliance bundle / screening / HIPAA |
| **Direct-secure (DirectTrust later)** | 3,897 (overdue) / 235,747 total | park until DirectTrust signup, then send via HISP |
Cold-emailable universe = **120,408 normal inboxes** (consumer webmail + practice
domains), all NPI-keyed. Direct/HISP universe = **235,747** addresses held for the
DirectTrust channel once you sign up — that becomes a huge, spam-resistant,
high-trust second wave.
### Strategy confirmed
- **Start now:** email the 120,408 cold inboxes the Provider Compliance Bundle,
leading the 1,909 overdue with the revalidation deadline.
- **Phase 2 (DirectTrust):** once registered, the 235,747 Direct addresses are a
second, higher-deliverability channel (DirectTrust is closed/trusted, not
spam-filtered like normal email).
- MX/SMTP-verify the cold list first (port 25 + MX confirmed working on our infra)
to strip dead addresses before sending and protect MTA reputation.
Output CSVs: `npi_all_cold_emailable.csv`, `npi_overdue_cold_emailable.csv`,
`npi_overdue_direct_secure.csv` (NPI, email, name, specialty, state, due date,
days overdue, LEIE flag, opt-out ending).