Correct ZoomInfo integration page - #706
Conversation
Document the new ZoomInfo GTM (OAuth) integration alongside the existing legacy credential-based integration. Changes include: - Updated intro to describe both integration methods and note they coexist - Restructured "Connect the integration" into two subsections: GTM OAuth (recommended, marked early access) and legacy credential-based - Added 6 new GTM tool steps: Search Contacts (GTM), Enrich Contacts (GTM), Search Companies (GTM), Enrich Companies (GTM), Taxonomy Lookup, and ZoomInfo GTM API Call - Added parallel "ZoomInfo GTM API Call" advanced section alongside legacy - Expanded best practices to cover integration method selection and OAuth token refresh behavior - Added 4 new FAQs: GTM vs legacy differences, account type requirements, Taxonomy Lookup explanation, and simultaneous use of both integrations Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
🎯 Vibe checkReviewed: 1 file (1 with issues, 0 clean) Scores
Score key: 🟢 9–10, 🟡 6–8, 🔴 1–5. ✨ Overall vibe: A well-written, well-structured integration page — the credit consumption section in particular is genuinely useful and the GTM vs legacy framing is clear. Main gaps are the "Agent" capitalization inconsistency (present throughout) and a missing link to ZoomInfo API docs that will leave advanced users hunting. 🔧 Issues (6)
🧩 Component suggestions (1)
✅ Clean files (0)All issues are in 🔋 Credit usage
Files read: |
The ZoomInfo OAuth provider and its six tool steps are hidden behind the
zoominfo-gtm-native flag, whose payload is {"force_internal_usage": true}
with no project or organization entries — no customer can reach them yet.
Documenting them as available was wrong, so this reverts to the
credential-based integration and fixes the errors on the page instead:
- Remove the Search contacts, Search companies, Enrich contact, and Enrich
company tool step cards. Those transformations are not in the registry;
only zoominfo_api_call exists.
- Describe Zoominfo API call as the single step all ZoomInfo operations run
through, and drop the account dropdown instruction — the step has no
oauth_account_id field.
- Replace the API call example, which used an endpoint and body shape that
do not exist, with a lookup call taken from the step's own field hint.
- Remove the unverified "built-in credit safeguards" claim.
- Add an FAQ noting an OAuth version is in development and not yet
available.
- Capitalize Agents and GTM Agents.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Summary
Corrects the ZoomInfo integration page. This PR originally documented the new ZoomInfo GTM (OAuth) integration as available; it is not, so that content has been removed and the existing page fixed instead.
Why the OAuth content was pulled
The
zoominfo_gtmprovider and all six GTM tool steps are hidden behind thezoominfo-gtm-nativefeature flag (hideWhen: "when_disabled", defaultfalse) in bothprovider_feature_flag_visibility.tsandstudio/transformations/feature_flag_visibility.ts.The prod flag payload is
{"force_internal_usage": true}— noprojectsmap, noorganizationsmap, no wildcard. Evaluated throughIsFeatureEnabledForProjectOrOrg, that resolves true only for Relevance employees. No customer can see or connect the integration today, so documenting the OAuth flow, its tool steps, or an early-access path would have been wrong.The OAuth documentation is written and sits in this branch's history (bbbf1e4). It can be restored once the flag payload has real orgs in it.
What this PR changes
zoominfo_api_callexists.zoominfo_api_callhas nooauth_account_idfield; authorization comes from the project credentials./companies/enrichendpoint and aninclude_attributesbody that do not exist, with a lookup call taken from the step's own field hint.The credential-based connection instructions are unchanged.
Linear issue
https://linear.app/relevance/issue/TSP-1326/
TSP-1326 is not fully closed by this PR — the GTM OAuth documentation is still owed and is blocked on the flag rollout.