Skip to main content
Connecting Apollo lets RevenueHero enrich every lead as it submits, so your rules can read company size, industry, location, job title and seniority in real time. Company enrichment and prospect enrichment are set up separately, so if you want both, you configure both.
BEFORE YOU BEGIN
  1. You must be an admin in Apollo with permission to generate API keys.
  2. You must be an admin in RevenueHero to access the enrichment settings.

​
Generate your Apollo API key

​
Step 1: Open the Apollo developer portal

Sign in to Apollo as an admin and click Settings → Integrations → API Keys. This opens the Apollo developer portal. In the sidebar, under API Management, click API Keys.
Apollo API keys page

​
Step 2: Create the key and select your enrichment endpoints

Click Create new key and give it a name you will recognise later, for example Apollo key for RevenueHero. Open the APIs dropdown and select the endpoints for the enrichment you want RevenueHero to run. RevenueHero can only enrich what the key allows, so select these before you generate it: Select both of the first two if you want company and prospect enrichment together, which is what most routing setups need. You can also toggle Set as master key to give the key every endpoint, but a key scoped to what RevenueHero calls is the safer choice.
Apollo Api Key Scopes 1

​
Step 3: Generate the key and copy it

Generate the key and copy it to your clipboard.

​
Connect Apollo to RevenueHero

​
Step 4: Open your enrichment settings

In RevenueHero, go to Settings → Enrichment in the left sidebar. Find the Apollo card and click Connect Apollo.
Enrichment settings in RevenueHero

​
Step 5: Enter your key and test the connection

Paste the Apollo API key you copied, and enter a valid email address for the test call. RevenueHero runs a live enrichment against that address, so you find out straight away whether the key works.
Apollo connection form in RevenueHero
Click Connect Now.

​
Choose what Apollo enriches

The API key alone does not decide whether you get prospect data. That is a separate setting on the connected integration, so check it once Apollo is live. In Settings → Enrichment, the Apollo card now shows a Connected label and a Configure link. Click Configure, then under Module used for enrichment click Change and pick one:
  • Both Contacts & Companies. Enriched data includes both the person’s and their company’s information. Pick this if your rules read a mix of the two, for example employee size to pick the team and seniority to pick the rep. Your Apollo key needs both api/v1/organizations/enrich and api/v1/people/match.
  • Only Companies. Enriched data includes only the company’s information. Pick this if you route purely on firmographics like employee size, industry or location. Your key needs api/v1/organizations/enrich.
Apollo Module Config
The module has to line up with the endpoints scoped on your Apollo key. Select Both Contacts & Companies with a key that only carries api/v1/organizations/enrich, and the contact conditions in your rules have no data to read.

​
Common Apollo enrichment fields

These are the Apollo fields used most often for lead qualification and routing. Use them to direct prospects to the right team, territory or meeting flow based on company size, location, industry, technology stack and persona. Company attributes. These need api/v1/organizations/enrich on your key, and work with either module. Prospect attributes. These need api/v1/people/match on your key, and the Both Contacts & Companies module. To act on any of these, set them as conditions in your matching rules to qualify or disqualify, and in your distribution rules to decide who the meeting goes to.
That’s it. You’ve successfully set up Apollo enrichment. 🎉🎉🎉