Apollo.io Integration
'Connect Apollo.io to Supervity, authorize access, and use Apollo.io contacts, companies, and email features in operators and workflows.'
This guide explains how to connect Apollo.io to Supervity, what data is available after connection, how operators can use Apollo.io data and actions within workflows, and how to remove the integration when needed.
Overview
The Supervity Apollo.io integration allows your workspace to securely connect Apollo.io as a governed platform capability.
Once connected, operators and workflows can use Apollo.io data and actions to automate sales prospecting, search for candidate/business contacts, enrich organization records, and orchestrate outbound email communications.
With the Apollo.io integration, Supervity can:
- Search and retrieve detailed contact records
- Create and update contact profiles
- Search and retrieve company profiles
- Create and update company records
- Send outbound emails to prospects
- List sent emails and campaigns
All Apollo.io access is governed through Supervity's security, permissions, and audit controls.
Prerequisites
Before connecting Apollo.io, ensure you have:
- An active Supervity workspace
- An active Apollo.io account
- Permission to authorize third-party applications on your Apollo.io account
Depending on your Apollo.io tenant configuration, some operations may require specific user permissions within your organization.
Adding the Apollo.io Integration
Follow these steps to connect Apollo.io to Supervity. If you encounter any issues during setup, refer to the Troubleshooting section of this guide.
Step 1: Open Integrations
- Log in to Supervity.
- From the left navigation bar, click the Integrations icon.
This opens the Integrations page, where all available integrations are listed. Connected integrations and available integrations can both be managed from this page.
Step 2: Select Apollo.io
- Locate Apollo.io in the available integrations list.
- Click Connect.
Step 3: Authorize Access
You will be redirected to Apollo.io's secure authorization page.
Review the requested permissions and click Allow to grant Supervity access to your Apollo.io account.
Supervity uses Apollo.io's standard OAuth 2.0 authorization flow. Your Apollo.io password is never shared with or stored by Supervity.
Step 4: Complete Connection
After authorization, you will be redirected back to Supervity.
The Apollo.io integration will appear as Connected on the Integrations page. Your workspace can now securely access Apollo.io capabilities according to the permissions granted.
Having trouble? See the Troubleshooting section for step-by-step help with common setup issues.
How Apollo.io Works in Supervity
After connection, Apollo.io becomes available as a governed platform tool.
Operators can use Apollo.io capabilities when planning and executing tasks, while workflows can automate actions using Apollo.io data.
Common use cases include:
- Enriching leads and incoming contacts dynamically
- Searching for key decision makers within targeted accounts
- Automatically updating company profile data inside internal CRM platforms
- Orchestrating automated outbound email communication based on criteria
- Retrieving activity history and logging email contacts to coordinate communications
Using Apollo.io in Operators
Connected Apollo.io capabilities become available to operators automatically. Operators determine when Apollo.io data or actions are required to complete a task and execute accordingly, while remaining governed by workspace permissions, security controls, and approval policies.
What Operators Can Do with Apollo.io
Operators can perform the following actions using Apollo.io:
- Search and filter contacts by parameter
- Retrieve individual contact profile details
- Create new contacts and update existing contacts
- Search and filter companies by domain, industry, or size
- Retrieve individual company details
- Create new companies and update company records
- Send emails to contacts and prospects
- Retrieve lists of sent emails and campaign history
Typical Operator Use Cases
| Use Case | Example |
|---|---|
| Lead Enrichment | Retrieve contact details (phone, email, title) using email addresses |
| Company Lookup | Query company size, industry, and HQ location using web domains |
| Prospecting Automation | Search for new target contacts matching specific ICP criteria |
| CRM Synchronization | Update internal contact database records with fresh Apollo.io data |
| Outbound Execution | Programmatically send emails to newly qualified contacts |
| Action Logs | List sent emails for activity logging and compliance reports |
Features & Prerequisites
For each Apollo.io capability available in Supervity, the following describes the use case and the prerequisites required before use.
Search Contacts
Use Case: Search for contacts in Apollo.io by name, email domain, job title, or location. Useful for sales prospecting and lead discovery.
Prerequisites:
- Apollo.io account connected to Supervity
Get Contact
Use Case: Retrieve detailed contact profiles and metadata by ID. Useful for gathering detailed profile information including contact email and phone numbers.
Prerequisites:
- Apollo.io account connected to Supervity
Create Contact
Use Case: Programmatically create a new contact record in Apollo.io. Useful for lead ingestion and CRM sync.
Prerequisites:
- Apollo.io account connected to Supervity
Update Contact
Use Case: Modify an existing contact's details in Apollo.io. Useful for database enrichment.
Prerequisites:
- Apollo.io account connected to Supervity
Search Companies
Use Case: Search for organizations by name, domain, industry, or size. Useful for company profiling, account mapping, and ICP verification.
Prerequisites:
- Apollo.io account connected to Supervity
Get Company
Use Case: Retrieve detailed company profile details by ID. Useful for deep corporate research and data enrichment.
Prerequisites:
- Apollo.io account connected to Supervity
Create Company
Use Case: Programmatically create a new company record in Apollo.io.
Prerequisites:
- Apollo.io account connected to Supervity
Update Company
Use Case: Modify an existing company record's details in Apollo.io.
Prerequisites:
- Apollo.io account connected to Supervity
Send Email
Use Case: Send an email directly to prospects or contacts. Useful for automating custom outbound sales messages.
Prerequisites:
- Apollo.io account connected to Supervity
- Connected outbound mailbox set up and active inside your Apollo.io account
List Emails
Use Case: Retrieve a list of sent emails. Useful for tracking outbound performance and recording activity history.
Prerequisites:
- Apollo.io account connected to Supervity
Permissions Requested
Supervity only requests the permissions required for enabled Apollo.io capabilities.
Depending on the features used in your workspace, permissions may include:
| Permission Type | Purpose |
|---|---|
| User Profile | Associate Apollo.io data with authorized user accounts |
| Contacts | Search, retrieve, create, and update contact profiles |
| Companies | Search, retrieve, create, and update organization profiles |
| Outbound Mail | Send outbound emails and list sent email history |
| Offline Access | Maintain integration connectivity without requiring constant re-authentication |
Supervity follows least-privilege principles and only accesses data necessary to provide requested functionality.
Authentication & Security
The Apollo.io integration uses OAuth 2.0 authentication.
Security controls include:
- Encrypted credential storage (AES-256)
- Scoped access policies
- Token refresh and rotation support
- Immediate revocation capabilities
- Workspace-level governance controls
- Complete audit logging
- TLS 1.3 for all connection pipelines
All Apollo.io access remains subject to Supervity security policies and role-based permissions.
Managing the Integration
View Connection Status
From the left navigation bar, click the Integrations icon.
For Apollo.io you can view:
- Connection status
- Granted permission categories
- Last usage information
- Associated workflows and operators
Reconnect Apollo.io
If Apollo.io authorization expires: Open the Integrations page from the left navigation bar. Select Apollo.io. Click Reconnect. Complete authorization again through the Apollo.io portal.
Existing workflows and operators do not need to be recreated.
Removing the Apollo.io Integration
You can remove the Apollo.io connection from your Supervity workspace at any time directly from within the Supervity platform.
Steps to Remove
Log in to Supervity. From the left navigation bar, click the Integrations icon. Locate and select Apollo.io from the integrations list. Click Disconnect. Confirm the action when prompted.
Implications of Removal
Once removed:
- Supervity immediately loses all access to your Apollo.io account and associated data
- No new Apollo.io data will be read or processed after removal
- All active Apollo.io connections within your Supervity workspace are terminated
- Scheduled or active workflows that depend on Apollo.io will stop executing
- Apollo-dependent workflow steps will fail safely with clear error messages
- Existing workflow definitions within Supervity are not deleted — only the active connection is terminated
- Historical execution logs remain available for auditing purposes
Disconnecting Apollo.io does not delete workflow definitions, operators, or previously generated outputs.
How Your Data Is Handled After Removal
Data Handling on Removal:
- Supervity immediately loses access to your Apollo.io account upon removal
- No new Apollo.io profiles or email data will be collected or processed after disconnection
- Temporary files processed during workflow execution are deleted after execution completes
- Apollo.io access tokens and all account-related data are permanently deleted from Supervity's platform within 15 minutes of disconnection — no background access continues after removal
Auditing & Observability
All Apollo.io activity performed through Supervity is logged.
Audit records include:
- Which operator requested access
- Which workflow executed the action
- Timestamp of execution
- Success or failure status
- Relevant inputs and outputs (sensitive values are redacted)
This supports compliance, troubleshooting, governance, and operational visibility.
Troubleshooting
If you encounter issues at any stage, refer to the steps below. For issues not covered here, contact the Supervity support team.
Authorization Failed During Setup
Likely Cause: Incorrect Apollo.io account used, or corporate tenant policies restricting third-party applications.
Resolution:
- Ensure you are signed in to the correct Apollo.io account.
- Verify with your organization's IT administrator that your account is allowed to authorize third-party applications (Admin Consent may be required).
- Return to Supervity → Integrations → Apollo.io and click Connect to retry.
- If the issue persists, contact your IT administrator.
Missing Contact or Company Data
Likely Cause: The requested record does not exist, or required search filters are too restrictive.
Resolution:
- Confirm that the contact or company exists under your Apollo.io platform interface.
- Adjust your search queries or parameters to match less restrictive conditions.
Connection Expired or Token Invalid
Likely Cause: Security policies may force token expiration or revocation.
Resolution:
- Go to Integrations → Apollo.io → Reconnect.
- Complete the Apollo.io authorization flow again.
- Existing workflows do not need to be reconfigured after reconnection.
Workflow Cannot Access Apollo.io
Likely Cause: Apollo.io may have been disconnected, or workspace governance policies may restrict access.
Resolution:
- Confirm Apollo.io is still connected under the Integrations page.
- Verify the workflow has permission to use Apollo.io within your workspace governance settings.
- Check that workspace policies allow Apollo.io execution for the relevant operators or workflows.
Emails Not Sending
Likely Cause: The connected outbound mailbox is inactive or disabled inside Apollo.io.
Resolution:
- Log in to Apollo.io.
- Verify that your sending mailbox is connected, authenticated, and in good health in Apollo's settings.
- Re-authenticate your Apollo.io integration inside Supervity.
Frequently Asked Questions
Q: Is my Apollo.io password shared with or stored by Supervity?
No. Supervity uses Apollo.io's secure OAuth 2.0 authorization flow. Your password is never shared or stored. Scoped access tokens are stored securely using AES-256 encryption.
Q: Can I limit which Apollo.io data Supervity can access?
Supervity requests only the permissions required for enabled capabilities, following least-privilege principles. You can review all requested scopes during the OAuth authorization step before approving.
Q: Will I need to reconfigure my workflows after reconnecting Apollo.io?
No. If you reconnect Apollo.io due to token expiry, existing workflows and operators will continue working without reconfiguration.
Q: What happens to my workflows if I disconnect or remove Apollo.io?
Workflow definitions are not deleted when Apollo.io is disconnected or removed. However, any workflow steps that depend on Apollo.io will fail safely with clear error messages until Apollo.io is reconnected.
Q: How do I authorize the Supervity Apollo.io integration?
Log in to Supervity at Supervity, navigate to the Integrations page from the left navigation bar, locate Apollo.io, and click Connect. You will be redirected to Apollo.io's authorization page where you can review and approve the requested permissions. After authorization, you will be redirected back to Supervity automatically. See the Adding the Apollo.io Integration section above for full step-by-step instructions.
Q: Who do I contact if I have an issue with the integration?
Contact the Supervity support team. See the Support section below for full contact details, support hours, and SLA information.
Support
If you need assistance with the Apollo.io integration, visit the Support page.
Support Hours
- Monday to Friday, 9:00 AM – 6:00 PM IST
- Requests submitted outside business hours will be addressed on the next business day
First Response SLA
- All support requests receive an initial response within 24 business hours
Contact Information
| Contact Type | Details |
|---|---|
| Support | Support & Contact |
| Sales Inquiries | sales@supervity.ai |
| Contact Form | https://www.supervity.ai/contact-us |
| Website | https://www.supervity.ai |
| Privacy Policy | https://supervity.ai/privacy-policy |
| Terms of Service | https://www.supervity.ai/terms-of-service |
| Acceptable Use Policy | https://supervity.ai/acceptable-use-policy |
When Contacting Support, Please Provide
- Workspace name
- Account type used for authorization
- Relevant workflow or operator information
- Error messages or screenshots when available
This helps the support team investigate and resolve issues more quickly.