Apollo.io integration overview

Apollo.io Overview

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

• Retrieve detailed company and contact information
• Validate company contact details
• Track open job postings
• Automate lead generation via people search within company

Action Enrich Person

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

Setup 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 enriched Person details, including job title, company, and contact information.

Action Enrich Company

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

Setup Inputs:

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

Output:

• Returns enriched Company details, including industry, employee count, and social media profiles.

Action Find Open Jobs

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

Setup Inputs:

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

Output:

• Returns an array of Job Postings with position details and a Total Jobs Count.

Action Find Account by ID

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

Setup Inputs:

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

Output:

• Returns an Account object containing detailed information about the specified account.

Action Find Contact by ID

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

Setup Inputs:

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

Output:

• Returns a Contact object with information such as job title, company, and contact details.

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.

Setup 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 relevant individuals based on the provided criteria, with detailed contact information.

FAQ

I received a 403 Forbidden response indicating that my API key is invalid, how do I resolve this?

This error generally means one of the following:

1. Invalid API Key: The API key might not be authorized for the enrich endpoint.
2. Insufficient Permissions: The API key could lack the necessary permissions to access this particular resource.
3. Endpoint Restrictions: The API key might not be configured for this specific endpoint or action on Apollo.io.To resolve it:

• Check API Permissions: Verify that the API key has access to the enrich endpoint.
• Confirm API Key Validity: Ensure the API key is active and correct.
• Contact Apollo.io Support: If permissions seem correct, Apollo’s support team might be able to clarify endpoint access for your API key.

For more guidance on how to properly scope your API key, reference Apollo.io’s documentation.

I received an error on the that I hit the Apollo rate limit, what can I do?

Apollo’s rate limits are set based on your current subscription plan. For details on these limits, refer to Apollo’s API pricing to understand the number of requests allowed per month.

To avoid reaching these limits, consider upgrading your plan. Alternatively, try processing data in smaller batches, such as 200 rows at a time, to stay within rate limits and control which rows to process.