Apollo
Apollo.io sales intelligence and engagement platform. Search and enrich people and organizations, manage contacts and accounts, create deals and tasks, and enroll contacts into sequences.
Connectors
Choose the connector that matches your authentication method. The options below use the names shown in StackAI.
Apollo (API Key)
API Key
Apollo (API Key)
Connect to Apollo.io with an API key. A master API key is required for most write operations (contacts, accounts, deals, tasks, sequences).
Set up in Apollo
Sign in to Apollo.io as an admin (or a user with the required permission profile).
Open Settings → Integrations → API Keys and click Create new key.
Toggle Set as master key so the key can access all endpoints; a master key is required for most write operations, such as creating contacts and accounts.
Copy the key and store it securely (you may not be able to view it again).
Set up in StackAI
Open Settings → Connections, add a connection, and select Apollo (API Key).
Enter the credentials and connection details in the fields below.
Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.
Connection fields
API Key
Yes
Apollo.io API key. Most write endpoints (contacts, accounts, tasks, deals, sequences) require a master API key. Generate one from Apollo Settings > Integrations > API.
Provider documentation: Setup reference.
Verify the connection
Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.
If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.
Use an action
Add the required Apollo action to the workflow.
Select a connection when the action requests one.
Complete the required fields. Use the reference picker when a value comes from another workflow step.
Run the workflow and inspect the action’s output. Check the result before using it in a later step.
Actions
Search People
Search Apollo's people database by keywords, titles, location, and more.
Inputs
Keywords
string
No
Keyword string matched against people records.
Person Titles
array
No
Job titles to match. Default: [].
Person Locations
array
No
Locations (city, state, country) to match. Default: [].
Organization Domains
array
No
Limit to people at companies with these domains. Default: [].
Organization IDs
array
No
Limit to people at organizations with these Apollo IDs. Default: [].
Seniorities
array
No
Apollo seniority buckets to include. Default: [].
Page
integer
No
1-indexed page number. Minimum: 1. Default: 1.
Results per page
integer
No
Number of results per page (max 100). Minimum: 1. Maximum: 100. Default: 25.
Outputs
People
object_array
People matching the search criteria.
Total Entries
number
Total number of people matching the search.
Page
number
Current page number.
Total Pages
number
Total number of available pages.
Enrich Person
Enrich a single person by email, name + domain, or LinkedIn URL.
Inputs
string
No
Email address of the person to enrich.
First Name
string
No
Person's first name (use with last_name and domain).
Last Name
string
No
Person's last name.
Company Domain
string
No
Employer domain.
LinkedIn URL
string
No
LinkedIn profile URL.
Reveal Personal Emails
boolean
No
Consumes an email credit to reveal personal emails. Default: false.
Reveal Phone Number
boolean
No
Consumes a credit to reveal phone numbers. Default: false.
Outputs
Person
object
Enriched person record.
Matched
boolean
True if Apollo found a matching person.
Bulk Enrich People
Enrich up to 10 people in a single API call.
Inputs
Details
array
Yes
List of up to 10 people to enrich. Each entry needs an email, or first_name+last_name+domain, or linkedin_url.
Reveal Personal Emails
boolean
No
Consumes credits to reveal personal emails. Default: false.
Reveal Phone Number
boolean
No
Consumes credits to reveal phone numbers. Default: false.
Outputs
Matches
object_array
List of enriched person records (null where no match).
Matched Count
number
Number of people successfully matched.
Search Organizations
Search Apollo's organization database by name, domain, location, size, or industry.
Inputs
Name Contains
string
No
Substring match against organization name.
Domains
array
No
Filter to specific domains. Default: [].
Locations
array
No
Headquarters locations. Default: [].
Employee Ranges
array
No
Employee-count bucket strings like '11,50'. Default: [].
Industries
array
No
Industry strings to match. Default: [].
Page
integer
No
1-indexed page number. Minimum: 1. Default: 1.
Results per page
integer
No
Number of results per page (max 100). Minimum: 1. Maximum: 100. Default: 25.
Outputs
Organizations
object_array
Matching organizations.
Total Entries
number
Total number of organizations matching the search.
Page
number
Current page.
Total Pages
number
Total available pages.
Enrich Organization
Enrich an organization using its domain.
Inputs
Domain
string
Yes
Bare domain of the organization to enrich.
Outputs
Organization
object
Enriched organization record.
Matched
boolean
True if Apollo matched an organization for this domain.
Create Contact
Create a new contact in your Apollo workspace.
Inputs
First Name
string
Yes
Contact's first name.
Last Name
string
Yes
Contact's last name.
Organization Name
string
No
Employer name.
Title
string
No
Job title.
string
No
Primary email address.
Website URL
string
No
Company website URL.
Direct Phone
string
No
Direct phone number.
Mobile Phone
string
No
Mobile phone number.
LinkedIn URL
string
No
LinkedIn profile URL.
Labels
array
No
List labels to apply to the contact. Default: [].
Contact Stage
select (string)
No
Contact stage to assign. Options load from the selected connection.
Owner
select (string)
No
Apollo user who owns the contact. Options load from the selected connection.
Run Dedupe
boolean
No
If true, Apollo dedupes against existing contacts. Default: true.
Outputs
Contact
object
The created contact record.
Contact ID
string
Apollo contact ID.
Contact URL
string
Apollo app URL for the contact.
Update Contact
Update an existing Apollo contact.
Inputs
Contact ID
string
Yes
Apollo contact ID to update.
First Name
string
No
New first name.
Last Name
string
No
New last name.
Organization Name
string
No
New employer name.
Title
string
No
New job title.
string
No
New primary email.
LinkedIn URL
string
No
New LinkedIn URL.
Labels
array
No
Replace the contact's labels with this list.
Contact Stage
select (string)
No
New contact stage. Options load from the selected connection.
Owner
select (string)
No
Reassign the contact to a different owner. Options load from the selected connection.
Outputs
Contact
object
Updated contact record.
Contact ID
string
Apollo contact ID.
Contact URL
string
Apollo app URL for the contact.
Search Contacts
Search contacts in your Apollo workspace by keywords and contact stage.
Inputs
Keywords
string
No
Free-text keywords matched against contact records.
Contact Stages
multiple_select (string)
No
Limit to contacts in these stages. Options load from the selected connection.
Page
integer
No
1-indexed page number. Minimum: 1. Default: 1.
Results per page
integer
No
Number of results per page (max 100). Minimum: 1. Maximum: 100. Default: 25.
Outputs
Contacts
object_array
Matching contacts.
Total Entries
number
Total contacts matching the filters.
Page
number
Current page.
Total Pages
number
Total available pages.
Create Account
Create a new account (company) in Apollo.
Inputs
Account Name
string
Yes
Company name.
Domain
string
No
Company primary domain.
Owner
select (string)
No
Apollo user who owns the account. Options load from the selected connection.
Account Stage
select (string)
No
Account stage. Options load from the selected connection.
Phone
string
No
Main company phone.
Address
string
No
Free-form company address.
Labels
array
No
Labels to tag the account with. Default: [].
Outputs
Account
object
The created account record.
Account ID
string
Apollo account ID.
Account URL
string
Apollo app URL for the account.
Create Deal
Create a new deal (opportunity) in Apollo.
Inputs
Deal Name
string
Yes
Deal name.
Owner
select (string)
No
Deal owner. Options load from the selected connection.
Account ID
string
No
Apollo account (company) ID.
Amount
number
No
Deal amount.
Stage
select (string)
No
Deal stage. Options load from the selected connection.
Close Date
date
No
Expected close date.
Description
textarea
No
Free-text description.
Is Closed
boolean
No
Whether the deal is closed.
Is Won
boolean
No
Whether the deal is won.
Source
string
No
Deal source.
Contact IDs
array
No
Apollo contact IDs associated with the deal. Default: [].
Outputs
Opportunity
object
Created opportunity record.
Opportunity ID
string
Apollo opportunity ID.
Opportunity URL
string
Apollo app URL for the opportunity.
List Deals
List opportunities (deals) in Apollo with optional sorting.
Inputs
Sort By
string
No
Field to sort by (e.g. 'amount', 'close_date').
Sort Ascending
boolean
No
True for ascending order, false for descending.
Page
integer
No
1-indexed page number. Minimum: 1. Default: 1.
Results per page
integer
No
Results per page (max 100). Minimum: 1. Maximum: 100. Default: 25.
Outputs
Opportunities
object_array
Opportunities on this page.
Total Entries
number
Total deals matching the filters.
Page
number
Current page.
Total Pages
number
Total available pages.
List Sequences
List Apollo sequences (emailer campaigns).
Inputs
Name Contains
string
No
Substring match against sequence name.
Page
integer
No
1-indexed page number. Minimum: 1. Default: 1.
Results per page
integer
No
Results per page (max 100). Minimum: 1. Maximum: 100. Default: 25.
Outputs
Sequences
object_array
Sequences on this page.
Total Entries
number
Total sequences matching the filters.
Page
number
Current page.
Total Pages
number
Total available pages.
Add Contacts to Sequence
Enroll Apollo contacts into a sequence, sending from the given mailbox.
Inputs
Sequence
select (string)
Yes
Apollo sequence to enroll contacts into. Options load from the selected connection.
Contact IDs
array
Yes
Apollo contact IDs to enroll.
Send From (Email Account)
select (string)
Yes
Linked Apollo mailbox that will send the emails. Options load from the selected connection.
Start Immediately
boolean
No
If true, contacts are enrolled in the active state and will receive sequence emails. Default: true.
Outputs
Sequence ID
string
Apollo sequence ID contacts were added to.
Sequence URL
string
Apollo app URL for the sequence.
Added Contact IDs
array
Contact IDs successfully enrolled.
Added Count
number
Number of contacts added to the sequence.
Skipped Contact IDs
array
Contact IDs Apollo did not enroll (e.g. already in the sequence).
Skipped Count
number
Number of contacts skipped by Apollo.
Create Task
Create a new task in Apollo.
Inputs
Assignee
select (string)
Yes
Apollo user assigned to the task. Options load from the selected connection.
Contact IDs
array
Yes
Apollo contact IDs the task targets.
Priority
select (string)
Yes
Task priority. Options load from the selected connection.
Due At
datetime
Yes
Task due date and time.
Type
select (string)
Yes
Apollo task type. Options load from the selected connection.
Status
select (string)
Yes
Task status. Options load from the selected connection.
Note
textarea
No
Free-text note for the task.
Outputs
Task
object
Created task record.
Task ID
string
Apollo task ID.
Important behavior
Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.
The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.
Last updated
Was this helpful?