Core concepts / Native connectors

Native connectors

Connect Mailchimp, HubSpot or Klaviyo and clean a list where it already lives, no export, no re-import. Pick an audience, we verify it in the background, and the verdicts are written straight back onto the contacts.

◈

No API call needed. Connectors are set up in the dashboard under Integrations, not through this API. Everything below describes what happens once you connect, so you know exactly what we touch in your account.

Connecting

Each tool connects with a key you generate there and paste once. We store it encrypted and use it only for the syncs you start.

Mailchimp — an API key from Account, Extras, API keys. Keep the -us14 style suffix on the end: that suffix is what identifies your data centre, and the key does not work without it.
HubSpot — a Private App token (HubSpot retired plain API keys in November 2022). It needs the crm.objects.contacts.read and crm.objects.contacts.write scopes, plus crm.lists.read.
Klaviyo — a Private API Key with read access to Lists and Profiles.

What a sync does

Choose a list and we pull its addresses, de-duplicate them, and run them through the same verification pipeline as a CSV upload. The run appears in your Bulk Jobs as a normal job and charges credits at the usual rate, so a sync costs exactly what verifying those addresses any other way would cost. One sync runs at a time per connected tool, so a double-click cannot bill you twice for the same list.

The tags

Each verdict has its own tag, and a contact gets at most one. They are separate rather than a single "bad" tag because the four mean genuinely different things and you act on them differently.

pv-good — the mailbox was confirmed to exist. Safe to send.
pv-risky — a catch-all domain, which accepts every address, so the mailbox could not be confirmed either way.
pv-invalid — the mailbox does not exist. Sending here earns a hard bounce.
pv-unknown — no definitive answer from the mail server (blocked, greylisted, timed out). You are never charged for an unknown.

Each tag is opt-in, because tagging is one API call per contact and a large audience should not pay for writes you did not ask for. pv-risky and pv-unknown are tag-only and are never removed: neither is proof an address is bad, so deleting them is not a call we will make for you.

Cleaning up

Remove invalid — unsubscribed (Mailchimp), suppressed (Klaviyo), or marked pv-removed (HubSpot, which has no suppression list for contacts). We never hard-delete, so your history and reporting survive.
Remove disposable — throwaway addresses are handled the same way.

◈

Nothing is destroyed. Removal means unsubscribe or suppress, never permanent deletion. If a sync fails part way, we write nothing back at all rather than acting on partial results.

Disconnecting

Disconnecting deletes the stored key immediately. Tags and suppressions already written into your tool stay exactly as they are, they are your data.

Something else?

More connectors are on the way. Until then, any tool with an API can be wired up through the REST API or an automation platform, and you can subscribe to results with webhooks.