Apollo.io integration

The Apollo and Clay integration enables users to find and enrich leads within Clay by leveraging Apollo.io's extensive B2B database.

Creating a table with Apollo.io

1. In a workbook, click + Add at the bottom.
2. Search for Apollo.io and select from the results.
3. In the modal, you will be asked to Select Apollo.io account.
   • If you haven't already connected your Apollo.io account, click + Add account and go through authentication.

Source Find People from Apollo

Find people in Apollo.io based on job titles and company domains.

Inputs

• Job Titles (Required): Enter job titles to search for, separated by commas (e.g., CEO, CTO, VP of Sales)
• Company Domains (Optional): Filter results to people at specific companies
• Limit (Optional): Maximum number of people to return (1-1,000)

Setting up the Apollo.io integration

1. While in a Clay table, click Add enrichment and search for Apollo.io.
2. Under Integrations, select one of the Apollo.io options.
3. In the modal, you will be asked to Select [Apollo.io](<http://Apollo.io>) account.
   • If you haven't already connected your Apollo.io account, click + Add account and go through authentication.

Using the Apollo.io integration

Action Enrich Person

Retrieve additional data about an individual in Apollo.io by providing identifying details.

Inputs

• First Name (Optional): First name of the individual
• Last Name (Optional): Last name of the individual
• Name (Optional): Full name of the individual
• Email Address (Optional): Email address of the individual
• Company Name (Optional): Company where the individual works
• Company Domain (Optional): Domain of the company
• Apollo ID (Optional): Unique Apollo ID for the person

Output:

Returns comprehensive person details including:

• Contact information (email, phone numbers)
• Job title and employment history
• Company and organization details
• LinkedIn profile and social URLs
• Department and seniority level
• Location information

Action Enrich Company

Enrich company data by providing a company domain, using Apollo.io's extensive database.

Inputs

• Company Domain: The domain of the company to enrich (e.g., "example.com")

Output:

Returns detailed company information including:

• Industry and company description
• Employee count and departmental headcount
• Annual revenue and financial data
• Technologies used (tech stack)
• Company headquarters and office locations
• Social media profiles (LinkedIn, Twitter, Facebook)
• Founded year and company type

Action Find Open Jobs

Retrieve open job postings for a company using Apollo.io's job database.

Inputs

• Company ID (Optional): Apollo organization ID to identify the company
• Job Search Terms (Optional): Keywords to filter job postings (comma-separated)

Output:

Returns:

• Job Postings array containing:
  • Job title
  • Job posting URL
  • Location (city, state, country)
  • Posted date and last seen date
• Total Jobs Count: Total number of open positions

Action Find Account by ID

Use this action to retrieve detailed information for a specific account in Apollo.io using an Account ID.

Inputs

• Apollo Account ID: The unique Account ID in Apollo to search for

Output:

Returns comprehensive account information including:

• Organization details (name, domain, industry)
• Employee count and company size
• Technologies and tech stack
• Contact information
• Office locations
• Social profiles and website information

Action Find Contact by ID

Retrieve detailed information about a specific contact in Apollo.io by using a Contact ID.

Inputs

• Apollo Contact ID: The unique Contact ID in Apollo to look up the contact

Output:

Returns detailed contact information including:

• Full name and job title
• Email addresses and phone numbers
• Company and account details
• LinkedIn profile and social URLs
• Email verification status
• Engagement history

Action Find People at Company By Job Title

Use this action to search for individuals at specified companies by their job titles within Apollo.io.

Inputs

• Job Titles: A comma-separated list of job titles to search for (e.g., "Marketing Manager, Sales Director")
• Company Domains: A comma-separated list of company domains to filter the search (e.g., "example.com")
• Locations (Optional): A comma-separated list of locations to further refine the search
• Limit (Optional): Specify the maximum number of people to return in the search, up to 10
• Include Contacts (Optional): Include relevant contacts from your linked CRM. If a limit is set, CRM contacts will be prioritized within the results

Output:

Returns a Results object containing:

• People array with details for each person found:
  • Name and contact information
  • Job title and seniority
  • Company and employment information
  • LinkedIn profile
  • Department and location
• Contact verification status
• Employment history

Action Find Saved Contacts

Find saved contacts in your Apollo.io account by searching with keywords.

Inputs

• Keywords: Keywords to search by (recommended to use email address for best results). Keywords can also include combinations of names, job titles, and employers (company names)
• Limit (Optional): Maximum number of contacts to return in the search (1-10)

Output:

Returns array of matching contacts including:

• Contact information (name, email, phone numbers)
• Job title and organization details
• LinkedIn profile
• Email verification status
• Contact stage and owner information
• Custom fields
• Sequence enrollment status (if applicable)

Action Find or Create Contact

Finds a contact in Apollo.io or creates a new one if it doesn't exist.

Inputs

• Run Dedupe (Optional, default: true): If enabled, Apollo will dedupe contacts by email address, LinkedIn URL, or name and organization name, returning existing contacts instead of creating duplicates
• First Name (Optional): First name of contact
• Last Name (Optional): Last name of contact
• Email (Optional): Email address of contact
• Job Title (Optional): Job title of contact
• Organization Name (Optional): Name of organization contact belongs to
• Website URL (Optional): Website URL of organization
• Account ID (Optional): Apollo ID of organization contact belongs to
• Direct Phone (Optional): Primary phone number for contact
• Mobile Phone (Optional): Mobile phone number of contact
• Present Raw Address (Optional): Personal location for contact (city, US state, country)
• Contact Stage ID (Optional): Current stage of contact in sales process
• Custom Fields (Optional): Custom fields defined in Apollo account settings

Output:

Returns contact object with:

• Contact ID and basic information
• Email verification status
• Organization and location details
• Custom field values
• A flag indicating whether the contact was newly created or already existed (was_existing)

Note: This action intelligently finds existing contacts when deduplication is enabled, preventing duplicate records in your Apollo account.

Action Update Contact

Updates an existing contact's information in Apollo.io.

Inputs

• Contact ID: Apollo contact ID to update
• First Name (Optional): First name of contact
• Last Name (Optional): Last name of contact
• Email (Optional): Email address of contact
• Job Title (Optional): Job title of contact
• Organization Name (Optional): Name of organization contact belongs to
• Website URL (Optional): Website URL of organization
• Account ID (Optional): Apollo ID of organization contact belongs to
• Direct Phone (Optional): Primary phone number for contact
• Mobile Phone (Optional): Mobile phone number of contact
• Present Raw Address (Optional): Personal location for contact (city, US state, country)
• Contact Stage ID (Optional): Current stage of contact in sales process
• Custom Fields (Optional): Custom fields defined in Apollo account settings

Output:

Returns updated contact object with:

• Complete contact information
• Email verification status
• Organization and location details
• Updated custom field values
• Metadata (owner, creator, timestamps)

Note: At least one optional field must be provided along with the Contact ID to perform an update.

Action Add Contact to Sequence

Add a contact to a sequence in Apollo.io. The contact must already exist in Apollo.io.

Plan Availability: Explorer plan and above

Inputs

• Sequence ID: ID of sequence to add contact to
• Contact ID: ID of contact to add to sequence
• Send Email From Email Account ID: ID of email account to send from
• User ID (Optional): ID of user adding the contact to sequence
• Add Without Email (Optional, default: false): Add contact to sequence without an email address?
• Add Unverified Email (Optional, default: false): Add contact to sequence with unverified email address?
• Add With Job Change (Optional, default: false): Add contact to sequence with a job change?
• Add Active in Other Campaigns (Optional, default: false): Add contact to sequence if active in other campaigns?
• Add Finished in Other Campaigns (Optional, default: false): Add contact to sequence if finished in other campaigns?

Output:

Returns confirmation of whether the contact was successfully added to the sequence, or if skipped, the reason for skipping (e.g., already in sequence, missing email, etc.)

Note: The optional override flags allow you to bypass common sequence enrollment restrictions.

Action Update Contact Status in Sequence

Update the status of a contact in a sequence in Apollo.io. The contact must already exist in Apollo.io and be enrolled in the sequence.

Plan Availability: Explorer plan and above

Inputs

• Sequence ID: ID of sequence the contact is in
• Contact ID: ID of contact to update in sequence
• Mode: Action to take on the contact:
  • Remove from Sequence: Permanently removes the contact from the sequence
  • Pause in Sequence: Pauses the contact in the sequence (can be resumed later)
  • Mark as Finished: Marks the contact as having completed the sequence

Output:

Returns confirmation of whether the contact's status was successfully updated, including details about the operation performed.

Note: Use this action to manage contact progression through your sequences, whether pausing outreach temporarily, removing contacts entirely, or marking campaigns as complete.

Run settings

• Auto-update
• Only run if: The enrichment will only run if conditions are met. (Learn more about conditional formulas here!)

‍