Outreach
This page describes how to use Census with Outreach.
Getting started
This guide shows you how to use Census to connect your Outreach account to your data warehouse and create your first sync.
Prerequisites
Before you begin, you'll need the following:
Census account: If you don't have this already, start with a free trial.
Outreach account: We recommend using a dedicated service account with Admin user profile privileges. (See Required Permissions.)
Have the proper credentials to access to your data source. See our docs for each supported data source for further information:
Step 1: Connect Outreach
Log into Census and navigate to Destinations.
Click New Destination.
Select Outreach from the dropdown list.
Follow the Outreach authentication flow, which will ask you to log in with your Outreach username and password.
Your end state should look something like this. 👇
Step 2: Connect your data warehouse
The steps for connecting your data warehouse will depend on your technology. See the following guides:
After connecting your warehouse, your Destinations page will look something like this: 👇
Step 3: Create your model
When defining models, you'll write SQL queries to select the data you want to see in Outreach. This can be as simple as selecting everything in a specific database table or as complex as creating new calculated values.
From inside your Census account, navigate to the Models page.
Enter a name for your model. You'll use this to select the model later.
Enter your SQL query. If you want to test the query, use the Preview button.
Click Save Model.
Step 4: Create your first sync
The sync will move data from your warehouse to Outreach. In this step, you'll define how that will work.
From inside your Census account, navigate to the Syncs page.
Under What data do you want to sync?, choose your data warehouse as the Connection and your model as the Source.
Under Where do you want to sync data to?, choose Outreach as the Connection and an Object in Outreach. (See Supported Objects.)
Under How should changes to the source be synced?, choose Update or Create. (See Supported Sync Behaviors.)
Under How are source and destination records matched?, select a mapping key. (See Supported Objects for details.)
Under Which properties should be updated?, select the fields you want to update by mapping a field in Outreach to a column in your model.
Click Next. This will open the Confirm Details page where you can see a recap of your setup.
If you want to start a sync immediately, set the Run a sync now? checkbox.
Click Create Sync.
When configuring your sync, the page should look something like this: 👇
Custom Fields in Outreach
Although the sync can update custom fields in Outreach, these fields will show up as Custom# rather than using the custom field name. You may need to visit the custom field configuration in Outreach settings to check the field number.
Step 5: Confirm the synced data in Outreach
Once your sync is complete, it's time to check your data. Open Outreach and check that the records updated correctly.
If everything went well, that's it! You've started syncing data from your warehouse to Outreach! 🎉
And if anything went wrong, contact the Census support team to get some help.
Sync speed
Sync speeds can be affected by API rate limiting from the destination app. Outreach allows an API call rate of up to 10,000 calls per hour, per user. (See Outreach API Documentation for details.)
In most cases, you won't run into any issue with sync speed based on rate limiting unless:
You're running an initial sync action that will update many records in Outreach.
You have another integration or service that's making API calls to Outreach and using the same user account.
Supported objects
Object Name
Supported?
Sync Keys
Account
✅
any Text field
Prospect
✅
Email (recommended), any Text field
User
✅
Email (recommended), any Text field
Let us know if you want Census to support additional objects for Outreach.
Supported sync behaviors
Learn more about all of our sync behaviors in our Syncs documentation.
Behavior
Supported?
Objects
Update or Create
✅
All
Let us know if you want Census to support additional sync behaviors for Outreach.
Email Identifier Formatting:
If you are using email as an identifier to sync to Prospects or Users Outreach requires the data to be formatted as an array.
You'll need to format your email identifiers in your source data to follow the format ["email@example.com"]
Please also note that your source column should still be typed as a text based column as Census only pulls in text or numeric source columns as available options for sync identifiers.
🔑 Required permissions
We recommend authenticating your Outreach connection with an Outreach user that has the standard Admin governance profile.
If using another profile, the profile must include permissions to view, create, and edit all records for the synced objects. See Outreach Support for details on user governance settings.
Need help connecting to Outreach?
You can send our support team an email at support@getcensus.com or start a conversation from the in-app chat.
Last updated
Was this helpful?
