Bring Your Own API Keys. We Orchestrate.

Already paying for Apollo or People Data Labs? Pass your API keys via HTTP headers on any OneSource enrichment call. We orchestrate the waterfall, handle deduplication, assign deterministic DIDs, and cache results in the oGraph. You keep your contracts and pricing. No vendor lock-in.

Connect Your KeysSee How It Works

How BYOK Works

Three HTTP headers. That is all it takes.

Your Quota

X-Apollo-Api-Key

Pass your Apollo API key on any enrichment request. OneSource routes Apollo calls through your account and quotas. Your existing volume discounts apply. The waterfall still checks oGraph cache first, so cached contacts never touch your Apollo quota.

Your Contract

X-PDL-Api-Key

Pass your People Data Labs API key to use your own PDL account. OneSource applies min_likelihood=6 filtering and handles the API integration. Your PDL contract and pricing remain unchanged.

Custom Order

X-Waterfall-Order

Customize which providers are tried first. Set X-Waterfall-Order: pdl,apollo to try PDL before Apollo, or any combination. The oGraph cache is always checked first regardless of waterfall order. Optimize for your specific data needs.

Full Stack

Orchestration Value

Even with your own keys, you get oGraph caching (free repeat lookups), deterministic DID assignment, Golden Record creation, waterfall fallback logic, and rate limiting. OneSource adds intelligence on top of raw provider access.

Stop Paying Twice for the Same Data

Without BYOK, switching to a new enrichment platform means paying for data you already license. With OneSource BYOK, you keep your existing Apollo or PDL investments and layer our orchestration on top. The oGraph cache means contacts you have already enriched are free on subsequent lookups, regardless of which provider originally returned the data. Your provider spend goes further.
No Double PaymentCache CompoundsKeep Your Contracts
See OneSource API
Media placeholder

What You Still Get with BYOK

BYOK is not a stripped-down mode. You get every OneSource capability: oGraph cache-first lookups (free), deterministic HMAC-SHA256 DID assignment, Golden Record creation and management, waterfall fallback to OneSource providers when your keys miss, credit-based metering, rate limiting, and full API access via REST, CLI, MCP, and Gateway. The only difference is which API keys fund the provider calls.
Full CapabilitiesDID AssignmentoGraph Caching
Media placeholder

BYOK FAQ

Apollo and People Data Labs (PDL) are supported via X-Apollo-Api-Key and X-PDL-Api-Key headers. Additional providers will be added as the BYOK surface expands. The CLI will support onesource provider add/list for key management.
Keys are passed per-request via HTTP headers and are never stored by OneSource. They are used only for the duration of the waterfall execution. Keys are not logged, not visible in any dashboard, and not shared across tenants.
The waterfall engine skips the rate-limited provider and routes to the next available provider in the waterfall order. If all BYOK providers are exhausted, the request falls back to OneSource system keys (consuming 1 credit).
Yes. Pass the X-Waterfall-Order header on each request. You might use pdl,apollo for contact enrichment and apollo for company enrichment. Each request can have its own provider priority.
BYOK is available on all OneSource plans. When your own keys fulfill a request, the standard 1-credit charge applies for the orchestration, caching, and DID resolution. The proposed BYOK orchestration fee is 0.25 credits per call when customer keys are used.

Bring Your Keys, Get Better Data

Add X-Apollo-Api-Key or X-PDL-Api-Key to your next enrichment call. Waterfall orchestration, DID resolution, and oGraph caching included.

Connect Your KeysTalk to Sales