Overview
The Apollo integration lets users connect their Apollo.io workspace so Alysio can search and enrich people and organizations, manage contacts and sequences, view deals and tasks, and query email and call history on their behalf. Users can ask Alysio to find people or companies in Apollo’s database, enrich by email or domain, search workspace contacts and accounts, list deals and tasks, add contacts to sequences, and search emails and calls—all in natural language. The integration uses the user’s connected Apollo credential. Search and enrichment may consume Apollo credits depending on your plan; display limits apply (e.g. 50,000 records across pagination). Supported capabilities / objects- People & organizations (Apollo database) — People search, organization search; people enrichment (by email, etc.), organization enrichment (by domain). Credit consumption may apply; not available on free plans.
- Workspace data — Account search, account stages; contact search, contact stages; deal list and deal view; task search and task create; list users; list email accounts.
- Sequences & outreach — Get sequence emails; add contact to sequence; update/remove contact from sequence.
- Email & calls — Get emails (outreach history); get email state; get calls (call history).
Authentication
Method: OAuth 2.0 (Apollo). The MCP sends requests using a Bearer token and a credential ID that identifies the user’s connected Apollo account. Requests are sent to the Apollo API (https://api.apollo.io/v1).
Redirect URI: Configured when the Apollo integration is set up in Alysio. The Apollo OAuth app must allow this redirect URI.
Token handling
- OAuth tokens for the connected Apollo account are stored securely and refreshed automatically.
- Each user/tenant has their own credential; the MCP sends the appropriate credential ID with each request so calls are isolated per connection.
- On disconnect, that credential is no longer used and Apollo tools will not be available for that user until they reconnect Apollo.
contacts:readpeople:readaccounts:readcalls:reademails:readenrich:read
MCP Tools
The Apollo MCP exposes the following tools. Users can invoke these capabilities through natural language in Alysio.| Tool | Description | Example user prompts |
|---|---|---|
apollo_people_search | Searches Apollo’s people database with filters (titles, location, etc.); does not return new email/phone; use enrichment for that. Credit consumption may apply; 50k display limit. | ”Find sales managers in California”, “Search for VPs of Engineering at tech companies.” |
apollo_organization_search | Searches Apollo’s company database with filters (employees, industry, etc.). Credit consumption may apply; 50k display limit. | ”Find companies with 100–500 employees in SaaS”, “Search for tech companies in Boston.” |
apollo_list_accounts_stages | Returns all account stages in the Apollo workspace. | ”List account stages”, “What account stages do we have?” |
apollo_account_search | Searches accounts in your Apollo workspace (not the global DB); use apollo_list_accounts_stages for stage IDs. 50k display limit. | ”Search our Apollo accounts”, “Find accounts in stage X.” |
apollo_people_enrichment | Enriches one person by email, name, domain, etc.; optional personal email and phone reveal (may consume credits). | ”Enrich john@company.com”, “Get full profile for this contact.” |
apollo_organization_enrichment | Enriches one organization by domain or other identifiers; returns industry, revenue, employees, funding, etc. | ”Enrich company.com”, “Get company details for this domain.” |
apollo_get_sequence_emails | Returns emails sent in a sequence (by sequence ID or other filters). | ”List emails in this sequence”, “Get sequence 123 emails.” |
apollo_get_emails | Searches your email outreach history with filters. | ”Find emails to this contact”, “Search my sent emails.” |
apollo_get_email_state | Returns the status of a specific email by email ID. | ”What’s the status of this email?”, “Get state for email 456.” |
apollo_get_calls | Searches your call history with filters (e.g. contact, user, date). | ”List calls with this contact”, “Get my calls from last week.” |
apollo_list_users | Returns all users in your Apollo organization. | ”List Apollo users”, “Who are our Apollo users?” (Use for user_id in tasks/sequences.) |
apollo_list_contacts_stages | Returns all contact stages in the Apollo workspace. | ”List contact stages”, “What contact stages do we have?” |
apollo_contact_search | Searches contacts in your Apollo workspace; use apollo_list_contacts_stages for stage IDs. 50k display limit. | ”Find contacts in stage Y”, “Search our Apollo contacts.” |
apollo_deal_list | Lists deals in your Apollo organization with optional filters; 50k display limit. | ”List all deals”, “Show deals in pipeline.” |
apollo_deal_view | Returns details for a single deal by deal ID; use apollo_deal_list to get deal IDs. | ”Show deal 123”, “Get details for this deal.” |
apollo_task_search | Searches tasks in your Apollo organization. | ”Find my tasks”, “Search tasks for this contact.” |
apollo_task_create | Creates a task (call, email, LinkedIn step, action item, etc.); use apollo_list_users for user_id and apollo_contact_search for contact_ids. | ”Create a follow-up call task for this contact”, “Schedule an email task.” |
apollo_get_list_of_email_accounts | Returns all email accounts in your Apollo organization. | ”List email accounts”, “Get email account IDs for sequences.” |
apollo_add_contact_to_sequence | Adds one or more contacts to a sequence; needs sequence ID, email account ID, contact IDs (from apollo_get_sequence_emails, apollo_get_list_of_email_accounts, apollo_contact_search). | ”Add this contact to sequence 123”, “Enroll contacts in this sequence.” |
apollo_update_contact_to_sequence | Updates or removes contacts from one or more sequences (e.g. stop participation). | ”Remove this contact from the sequence”, “Update sequence assignment for these contacts.” |
App Behavior
- API calls are made on-demand only when the user asks something that requires Apollo data or an action (e.g. search people/orgs, enrich, search contacts/accounts/deals, list or create tasks, get emails/calls, add/update sequence). There is no background sync; each request triggers the relevant Apollo API call using the user’s OAuth credential.
- User asks: “Add this contact to our Q1 outreach sequence.”
- Alysio routes the request to the Apollo MCP.
- The MCP may call
apollo_get_sequence_emailsto find the sequence ID,apollo_get_list_of_email_accountsfor the email account ID, andapollo_contact_searchfor contact IDs, thenapollo_add_contact_to_sequencewith those IDs. - The request is sent to the Apollo API using the user’s stored OAuth credential.
- The MCP returns the result; Alysio confirms in chat.
Troubleshooting
Common issues- Missing or expired connection — User sees errors or no Apollo data. Fix: Reconnect Apollo in Settings → Integrations (re-authorize with Apollo via OAuth 2.0).
- 401 Unauthorized — Token invalid or expired. Fix: Re-authorize the integration in Settings → Integrations.
- 403 Forbidden — Insufficient OAuth scopes or plan limits. Fix: Ensure the Apollo OAuth app has the required scopes; confirm the Apollo plan allows the requested feature (e.g. people search not on free plan).
- Credit consumption / not available on free plan — People Search, Organization Search, and some enrichment options consume credits and are not available on free plans. Fix: Add filters to narrow search; upgrade plan or use only allowed endpoints.
- 50,000 record display limit — Search endpoints return up to 50k records (100 per page, 500 pages). Fix: Use tighter filters and pagination to stay within limit.
- Enrichment returns no match — Provide more identifiers (e.g. email + domain) for better match rate. Fix: Use people enrichment with email or name+domain; use organization enrichment with domain.
- Email: support@alysio.ai