> ## 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. # Apollo > Connect Alysio to Apollo using OAuth 2.0 ## Overview The Apollo integration allows Alysio to securely connect with your Apollo workspace to access prospecting data, enrichment capabilities, outreach activity, and sales engagement records. Once connected, Alysio can search Apollo’s people and company database, retrieve workspace contacts and accounts, analyze deals and tasks, and interact with sequence activity. Users can ask Alysio to perform these actions using natural language, enabling faster prospect discovery and workflow automation across the revenue stack. This integration allows revenue teams to unify prospecting intelligence with CRM, pipeline, and engagement insights inside Alysio. Typical use cases include identifying new prospects, enriching contact records, reviewing outreach activity, and managing tasks or sequence participation. *** ## Supported Data and Capabilities The Apollo integration allows Alysio to access the following objects and capabilities. ### People and Organizations Search Apollo’s global database for people and organizations using filters such as job title, company size, industry, and location. Enrichment capabilities allow retrieval of detailed contact profiles based on email, domain, or other identifiers. Note that certain enrichment operations may consume Apollo credits depending on the account plan. *** ### Workspace Accounts and Contacts Search accounts and contacts within the organization’s Apollo workspace. Users can retrieve account stages, contact stages, and associated metadata related to prospecting and engagement activity. *** ### Deals and Tasks Access deal data stored in Apollo and retrieve deal details by ID. Users can search tasks, create new tasks, and review activity tied to accounts or contacts. *** ### Sequences and Outreach Retrieve sequence emails and manage sequence participation. Users can add contacts to sequences, update sequence participation, or remove contacts from active sequences. *** ### Email and Call History Retrieve historical outreach activity including emails and calls associated with contacts and accounts. This enables revenue teams to review prior engagement before taking action on accounts or opportunities. *** ## Authentication The Apollo integration uses OAuth 2.0 authentication. During the integration process, users authorize Alysio to access their Apollo workspace through the Apollo OAuth authorization flow. This allows Alysio to retrieve and interact with Apollo data using scoped permissions granted during authorization. OAuth tokens are stored securely and automatically refreshed according to Apollo’s token policies. *** ## Credential Handling Authentication credentials are stored securely within the Alysio platform. Each workspace maintains its own OAuth credentials, ensuring requests remain isolated per organization. If the integration is disconnected or OAuth credentials expire, users must reconnect the Apollo integration in the Alysio workspace. *** ## Required Permissions and Scopes The Apollo integration may request the following permissions depending on the capabilities used. contacts:read\ people:read\ accounts:read\ calls:read\ emails:read\ enrich:read These scopes allow Alysio to retrieve and interact with Apollo data required to support prospecting, enrichment, and outreach workflows. *** ## MCP Tools The Apollo MCP exposes a set of tools that allow Alysio to query Apollo data using natural language prompts. *** ### apollo\_people\_search Search Apollo’s people database using filters such as job title, company size, industry, or location. Example prompts Find sales managers in California\ Search for VP of Engineering at SaaS companies Note that search results may be limited to 50,000 records across pagination. *** ### apollo\_organization\_search Search Apollo’s company database using filters such as industry, employee count, or location. Example prompts Find SaaS companies with 100 to 500 employees\ Search for technology companies in Boston *** ### apollo\_people\_enrichment Retrieve detailed contact information for an individual using identifiers such as email or domain. Example prompts Enrich [john@company.com](mailto:john@company.com)\ Get full profile for this contact Some enrichment operations may consume Apollo credits. *** ### apollo\_account\_search Search accounts within the Apollo workspace. Example prompts Search our Apollo accounts\ Find accounts in stage Prospecting *** ### apollo\_deal\_list List deals stored in Apollo. Example prompts List all deals\ Show deals in pipeline *** ### apollo\_task\_create Create tasks associated with contacts or accounts. Example prompts Create a follow up call task for this contact\ Schedule an email task *** ### apollo\_add\_contact\_to\_sequence Add one or more contacts to an outreach sequence. Example prompts Add this contact to our Q1 outreach sequence\ Enroll these contacts in the sequence *** ## App Behavior Alysio retrieves Apollo data on demand when users request information or initiate actions involving Apollo records. There is no continuous background synchronization. Instead, API requests are executed in real time based on user queries. This ensures the data returned reflects the most recent information available within the connected Apollo workspace. *** ## Example Workflow User asks: Add this contact to our outbound sequence. Alysio routes the request to the Apollo MCP. The MCP retrieves the sequence ID and contact ID using Apollo search tools. The system sends the request to the Apollo API using the stored OAuth credential. Apollo confirms the update. Alysio returns the result in the conversation interface. *** ## Troubleshooting ### Apollo Not Connected The integration has not been authorized. Solution\ Navigate to Settings → Integrations and connect Apollo using OAuth. *** ### OAuth Token Expired The OAuth token may have expired or been revoked. Solution\ Reconnect Apollo through the integrations settings. *** ### Search Limits Apollo search endpoints may return up to 50,000 results across pagination. Solution\ Use filters to narrow search results. *** ## Support For assistance configuring the Apollo integration or troubleshooting issues, contact [support@alysio.ai](mailto:support@alysio.ai)