Overview
The ZoomInfo integration connects Alysio to your ZoomInfo environment so you can search and enrich B2B data through natural language prompts. Teams use this integration to Find contacts and companies that match ICP criteriaEnrich leads and accounts by email or domain
Surface intent signals, scoops, and news for account research
Pull org charts and tech stack intelligence
Generate account summaries and Q and A style insights using ZoomInfo Copilot This integration is read-only. Alysio does not write, modify, or delete data in ZoomInfo.
Supported Data and Capabilities
Search
Run searches with filters and pagination Contact searchCompany search
Intent signals search
News search
Scoops search
Data Lookup
Retrieve reference lists used for valid filter values. Examples include job titles, industries, intent topics, news categories, scoop types, and technology categories. Best practiceUse lookup tools first when filtering by controlled values such as intent topics, categories, or scoop types.
Enrichment
Enrich records and retrieve deeper intelligence Contact enrich by email or match inputsCompany enrich by companyId, domain, or website
Intent enrich and topic level signals
News enrich with category filters
Scoops enrich with type filters
Company technologies and tech stack
Corporate hierarchy and subsidiaries
Org charts and reporting structure
Company hashtags and social indicators
Copilot
Use ZoomInfo Copilot features when enabled in your ZoomInfo subscription Account summaries by companyIdNatural language questions about an account
Insights by signal type such as funding, intent, or scoops
Authentication
Method
OAuth 2.0 with ZoomInfo Alysio sends requests using a Bearer token and a credential ID tied to the user’s ZoomInfo connection. Requests are sent to ZoomInfo’s Data API and Copilot API using JSON:API formatting.Redirect URI
Configured during ZoomInfo integration setup in Alysio and must be allowed in your ZoomInfo OAuth application settings.Token Handling and Connection Isolation
OAuth tokens are securely stored and refreshed as needed. Each user or tenant has their own credential. Alysio uses the correct credential for every request so data access stays isolated per connection. If the connection is removed or expires, ZoomInfo tools will stop working until the user reconnects.Permissions and Scopes
ZoomInfo permissions are contract dependent. Exact scope names vary by ZoomInfo plan. Your ZoomInfo account must have API permissions for the capabilities you want to use, such as Contact search and enrichCompany search and enrich
Intent, news, and scoops access
Lookup endpoints for filter values
Copilot account summary, questions, and insights If Copilot or certain enrich endpoints are not included in your ZoomInfo plan, those requests will return authorization errors.
API Usage and Request Characteristics
Alysio uses ZoomInfo APIs on-demand only. There is no background sync and no data persistence. Request formatJSON:API style payloads using application/vnd.api+json Pagination
Default 20 items per page, maximum 100 per page depending on endpoint and policy Reliability
Timeout support up to 10 minutes for long running searches
Automatic retries for transient errors based on platform configuration
MCP Tools
The ZoomInfo MCP provides tools that allow Alysio to search, enrich, and query Copilot in natural language.Lookup
zoominfo_data_lookup
Returns reference lists used for filters, such as industries, intent topics, and scoop types. Example prompts What intent topics are availableGet the list of industries for filtering
Show scoop types I can filter by
Search
zoominfo_contact_search
Searches contacts by criteria such as title, company, seniority, geography, and email. Example prompts Find VP Sales contacts at cybersecurity companies in UtahSearch for contacts at Acme
zoominfo_company_search
Searches companies by criteria such as name, domain, size, revenue, and industry. Example prompts Find healthcare companies with 500 plus employeesSearch for companies in Boston
zoominfo_intent_search
Searches for companies showing intent by topic. Best practiceUse zoominfo_data_lookup with lookupType intent-topics to get valid topics first. Example prompts Find companies showing intent for CRM
Companies with buying signals for data warehouse
zoominfo_news_search
Searches news coverage and articles. Best practiceUse zoominfo_data_lookup with news-categories for valid categories before filtering. Example prompts News about Acme in the last 30 days
Search recent funding news
zoominfo_scoops_search
Searches scoops and insider intelligence. Best practiceUse zoominfo_data_lookup with scoop-types for valid types before filtering. Example prompts Scoops about executive changes at Acme
Find growth scoops for this company
Enrich
zoominfo_contact_enrich
Enriches a contact profile using match inputs such as email. Example prompts Enrich contact for john@company.comGet full profile for this contact
zoominfo_company_enrich
Enriches a company profile using companyId, domain, or website. Example prompts Enrich company by domain company.comGet the full company profile for Acme
zoominfo_intent_enrich
Returns detailed intent data for companies. Example prompts Get intent signals for company 123Enrich intent for Acme
zoominfo_news_enrich
Returns detailed news intelligence for a company. Example prompts Get news for company 123Enrich news for Acme
zoominfo_scoops_enrich
Returns detailed scoops for a company. Example prompts Get scoops for company 123Show me hiring and exec change scoops for this account
zoominfo_company_technologies_enrich
Returns technology and tech stack data. Example prompts What tech does this company useGet tech stack for company 123
zoominfo_corporate_hierarchy_enrich
Returns corporate hierarchy and parent child relationships. Example prompts What is the corporate hierarchy for this accountWho is the parent company for Acme
zoominfo_org_charts_enrich
Returns org chart and reporting structure. Example prompts Show the org chart for AcmeGet the org chart for company 123
zoominfo_company_hashtag_enrich
Returns hashtag and social indicators. Example prompts What hashtags does this company useGet company hashtag data for company 123
Copilot
zoominfo_get_copilot_account_summary
Returns a Copilot account summary for a companyId. Example prompts Give me an account summary for AcmeCopilot summary for company 123
zoominfo_copilot_account_summary_question
Asks a natural language question about an account. Example prompts Ask Copilot who are the decision makers at AcmeAsk Copilot what are the risk signals for this account
zoominfo_copilot_insights_by_type
Returns Copilot insights by signal type such as funding, intent, or scoops. Example prompts Get funding insights for these companiesCopilot intent insights for company 123
App Behavior
Alysio calls ZoomInfo APIs only when a user requests ZoomInfo data. There is no background sync.Data is retrieved in real time and displayed in Alysio.
Alysio does not write data back into ZoomInfo.
Example Workflow
User asks Find tech companies with more than 500 employees and give me an account summary for the top 3. Alysio actions Runs zoominfo_company_search with employee and industry filtersReturns a list of matching companies
Uses companyId values to call zoominfo_get_copilot_account_summary for selected companies
Displays summaries in chat
Troubleshooting
Missing or Expired Connection
ZoomInfo is not connected or the credential is expired. FixReconnect ZoomInfo in Settings → Integrations and complete the OAuth authorization flow.
401 Unauthorized
Credential is invalid, expired, or revoked. FixReauthorize the integration and confirm the ZoomInfo user has API access enabled.
403 Forbidden
Your ZoomInfo subscription may not include the endpoint or capability requested such as Copilot. FixConfirm your ZoomInfo plan includes the required API features and permissions. If needed, remove Copilot requests and use standard search or enrich endpoints.
Invalid Filter Values
Search fails due to invalid topic, category, or scoop type. FixUse zoominfo_data_lookup to retrieve valid filter values, then apply those values in searches.
Missing companyId for Enrich or Copilot
Many enrich and Copilot tools require a companyId. FixRun zoominfo_company_search first using company name or domain and use the returned companyId.
Empty Results
ZoomInfo coverage varies by region and segment and strict filters can eliminate matches. FixWiden search criteria, try using domain instead of company name, or reduce filter constraints.