ZoomInfo
Enrich contacts and companies inside any workflow, using your own ZoomInfo API credentials.
You will need:
- A ZoomInfo plan with Enterprise API access.
- A ZoomInfo admin account, to generate the credentials.
Get your credentials from ZoomInfo
- Sign in to the ZoomInfo Admin Portal as an admin.
- Go to Integrations → API & Webhooks and click Generate New Token. On older ZoomInfo accounts this screen is Admin Portal → API and the button is Generate New Key.
- Copy the Client ID and the Private Key, and store them securely. ZoomInfo shows the Private Key once — if you lose it, generate a new token.
Careful
The Private Key is not your Client Secret. It is a long multi-line block that starts with -----BEGIN PRIVATE KEY-----. Pasting the Client Secret saves fine but can never authenticate.
ZoomInfo's own references, if you need them:
- Overview of ZoomInfo Enterprise API, in their Knowledge Center. Needs a ZoomInfo login.
- Enterprise API getting started guide, a PDF with the same steps.
- Enterprise API reference, under Authentication methods.
Connect in Floqer
Log in to app.floqer.com, go to Connections → ZoomInfo, and fill in three fields:
| Field | What to enter |
|---|---|
| UserEmail | The email you sign in to ZoomInfo with |
| Client Id | The Client ID from step 3 above |
| Private Key | The whole private key block, BEGIN and END lines included |
Careful
On older Floqer builds the third field is labelled Client Secret. It is the same field and it still needs the Private Key, not your ZoomInfo Client Secret.
-
If other people in your org need this connection, turn on Enable for Org. Leave it off to keep it to yourself.
-
Click Connect to ZoomInfo.
-
The key never expires. ZoomInfo recommends replacing it every 90 days. Generating a new token invalidates the previous one.
-
To replace it, open the connection, paste the new key, and click Save Changes. Floqer caches the ZoomInfo access token for up to an hour, so workflows pick up a replaced key within that window.
Check that it works
Add ZoomInfo: Contact Enrich to a workflow, map Email Address to a column, and run one row.
Careful
A populated Input Fields dropdown is not proof. It falls back to a built-in list when Floqer cannot reach ZoomInfo. Only a row that returns data confirms the connection.
The two actions
Both sit under People Data → People Enrichment in the action picker. Each is also listed a second time: Contact Enrich under People Data → Contact Enrichment, Company Enrich under Company Data → Company Enrichment. Same action either way.
| Action | Returns |
|---|---|
| ZoomInfo: Contact Enrich | Work email, direct and mobile phone, job title, management level, employment history, location, plus the company fields below |
| ZoomInfo: Company Enrich | Domain, revenue, employee count, industry, SIC and NAICS codes, social URLs |
- Map one input or several. Email alone works, so does name plus company.
- More inputs usually match better. At least one must have a value.
- The inputs offered are read live from your ZoomInfo account.
- Fields your package excludes are dropped automatically, and re-checked daily.
Credits
- ZoomInfo actions cost 0 Floqer credits.
- ZoomInfo charges one of its own credits the first time a record is enriched. Re-enriching that record is free on their side for the next twelve months, though it still counts toward your Records Under Management.
- Floqer caches results, so repeating an action over the same inputs sends no new request.
Troubleshooting
| What you see | What to do |
|---|---|
malformed plain PKCS8 private key(code:001) | The saved value is not a private key. Most often the ZoomInfo Client Secret was pasted instead of the Private Key. It also appears if the block was truncated or copied with surrounding quotes. Re-copy the Private Key, BEGIN to END |
malformed PKCS8 private key(code:003) | The key is PKCS#1. Use the block starting with BEGIN PRIVATE KEY, not BEGIN RSA PRIVATE KEY |
malformed plain PKCS8 private key(code:002) | The key is passphrase-protected. Generate an unencrypted key in ZoomInfo |
ZoomInfo API key not found | Reconnect ZoomInfo. Turn on Enable for Org if a teammate's workflow needs it |
All input fields are empty | Map a column that has data on that row |
No data found (matchStatus: ...) | No match at ZoomInfo. Normal for some rows. Map more inputs |
HTTP 401 | Credentials rejected. Check the key is the PKI key and is still active in ZoomInfo |
HTTP 403 | Your plan lacks this endpoint. Ask your ZoomInfo account manager about Enterprise API access |
To cut access, delete the token in ZoomInfo, or delete the connection in Floqer under Connections.
Have a question that isn't answered here? Contact Floqer support at hello@floqer.com.