> ## Documentation Index > Fetch the complete documentation index at: https://docs.alysio.ai/llms.txt > Use this file to discover all available pages before exploring further. # ZoomInfo > Connect Alysio to ZoomInfo using OAuth 2.0 ## 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 criteria\ Enrich 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 search\ Company 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 practice\ Use 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 inputs\ Company 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 companyId\ Natural 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 enrich\ Company 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 format\ JSON: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 available\ Get 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 Utah\ Search 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 employees\ Search for companies in Boston *** ### zoominfo\_intent\_search Searches for companies showing intent by topic. Best practice\ Use 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 practice\ Use 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 practice\ Use 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.com](mailto:john@company.com)\ Get full profile for this contact *** ### zoominfo\_company\_enrich Enriches a company profile using companyId, domain, or website. Example prompts Enrich company by domain company.com\ Get the full company profile for Acme *** ### zoominfo\_intent\_enrich Returns detailed intent data for companies. Example prompts Get intent signals for company 123\ Enrich intent for Acme *** ### zoominfo\_news\_enrich Returns detailed news intelligence for a company. Example prompts Get news for company 123\ Enrich news for Acme *** ### zoominfo\_scoops\_enrich Returns detailed scoops for a company. Example prompts Get scoops for company 123\ Show 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 use\ Get 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 account\ Who is the parent company for Acme *** ### zoominfo\_org\_charts\_enrich Returns org chart and reporting structure. Example prompts Show the org chart for Acme\ Get the org chart for company 123 *** ### zoominfo\_company\_hashtag\_enrich Returns hashtag and social indicators. Example prompts What hashtags does this company use\ Get 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 Acme\ Copilot 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 Acme\ Ask 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 companies\ Copilot 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 filters\ Returns 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. Fix\ Reconnect ZoomInfo in Settings → Integrations and complete the OAuth authorization flow. *** ### 401 Unauthorized Credential is invalid, expired, or revoked. Fix\ Reauthorize 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. Fix\ Confirm 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. Fix\ Use 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. Fix\ Run 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. Fix\ Widen search criteria, try using domain instead of company name, or reduce filter constraints. *** ## Support For help with setup or troubleshooting contact [support@alysio.ai](mailto:support@alysio.ai)