Apollo
This page describes how to use Census with Apollo.

In this guide, we will show you how to connect Apollo to Census and create your first sync.

Apollo lets you create a number of API keys, each with their own set of permissions. You'll almost certainly want to create a new API key for Census rather than reusing an existing one.
In Apollo's top navigation bar, click Enrich > API Enrichment.
Then, inside API Management, click API Keys.
Next, click Create New Key.
Provide a name you'll recognize ("Census" is a good choice) and select the Set as Master Key.
Click Create API Key.
Finally, copy the code you see under API Key. We'll use that in a minute.

Great! Now let's pull it all together.
  1. 1.
    In the Connections **** page, click on Add Service, and select "Apollo"
  2. 2.
    You can provide whatever name you like for the connection
  3. 3.
    Paste your Apollo API Key
  4. 4.
    Click Connect
Census will test your API key and show a green checkmark
โœ…
when successful.

Please follow one of our short guides depending on your data warehouse technology

Now navigate to the Model page in Censusโ€‹
Here you will have to write SQL queries to select the data you want to see in Apollo. Here are some ideas of data you should select:
  • Customer attributes like name, organization, title, email, etc.
  • Account attributes like name, domain, phone number, address
Once you have created your model, click Save Model.

Now head to the Sync page and click the Create a Sync button
In the "What data do you want to sync?" section
  • For the Connection, select the data warehouse you connected in step 3
  • For the Source, select the model you created in step 4
Next up is the "Where do you want to sync data to?" section
  • Pick Apollo as the Connection
  • For Object, pick the one you want to sync data to: Account or Contact
For the " How do you want to update the destination?" section
  • Select Update or Create or Update Only
  • Pick the right mapping key.
    • If you select Update or Create, it will be:
      • Email for Contacts, or
      • Name for Accounts
    • If you select Update Only, it will be:
      • ID or Email for Contacts, or
      • ID or Name for Accounts
Finally, select the properties you want to update in the Mapper in the "Which properties should be updated?" section
  • Here simply map the fields from Apollo to the column from your model.
The end result should look something like this
Click the Next button to see the final preview which will have a recap of what will happen when you start the sync

Now go back to your Apollo account and go view a record type (Contact or Account) that should have been updated. If everything went well, you should see your data in Apollo.
That's it! In 6 steps, you connected Census to Apollo and started syncing customer & account data from your warehouse to Apollo๐ŸŽ‰

Census currently supports syncing to the following Apollo objects.
Object Name
Supported?
Identifiers
Account
โœ…
Name
Contact
โœ…
Email
โ€‹Contact us if you want Census to support more objects for Apollo.

Learn more about all of our sync behaviors on our Core Concepts page.
Behaviors
Supported?
Objects
Update or Create
โ€‹โœ…โ€‹
Account, Contact
Update Only
โœ…
Account, Contact
โ€‹Contact us if you want Census to support more sync behaviors for Apollo.

โ€‹Contact us via [email protected] or start a conversation with us via the in-app chat.
Copy link
On this page
๐Ÿƒโ€โ™€๏ธ Getting Started
Prerequisites
1. Create an Apollo API key
2. Connect Census to Apollo
3. Connect to your Data Warehouse
4. Create your first Model
5. Create your first Sync
6. Confirm the data is in Apollo
๐Ÿ—„ Supported Objects
๐Ÿ”„ Supported Sync Behaviors
๐Ÿš‘ Need help connecting to Apollo?