We're hiring! View open positions →
DonorAtlas for Salesforce

Salesforce Quick Start Guide

1

Install the Integration

Click here to install the DonorAtlas integration for Salesforce.

Install the DonorAtlas Salesforce integration
2

Log in to DonorAtlas

Go to the DonorAtlas Configuration page from the App Launcher. Press Log in to log in to DonorAtlas.

DonorAtlas Configuration page with Log in button
3

Connect Your Account

Log in to your DonorAtlas account, and click Allow when redirected back to Salesforce. Once you're finished, you'll see a Connection Successful! screen!

Connection Successful screen after linking DonorAtlas
4

Configure Field Mappings

Go back to the DonorAtlas Configuration app in Salesforce and fill out the Contact, Lead, and Account field mappings. This tells DonorAtlas which Salesforce data to use to match to DonorAtlas donor profiles. Click Save Mappings at the bottom to save.

Contact, Lead, and Account field mappings configured in DonorAtlas
5

Edit the Contact, Lead, or Account Page

Go to a Contact, Lead, or Account (Person Account) page and click the Gear icon in the top right, and then Edit Page.

Gear icon menu with Edit Page option on a Salesforce Contact
6

Find the DonorAtlas Component

On the left (under Components), scroll to the bottom until you see DonorAtlasDonorAtlas Sync.

Lightning App Builder showing DonorAtlas Sync component
7

Place the Component

Drag the DonorAtlasDonorAtlas Sync component onto the Contact, Lead, or Account page. We recommend placing it above the Activity box on the right. Click Save, and Activate the component.

DonorAtlas Sync component placed on the Contact page layout
8

Activate the Donor Record Page

Navigate to any Donor record, click the Gear icon Edit Page, then use the Pages dropdown at the top of the Lightning App Builder to open the Donor Record Page. Click Activation in the top right and activate it for the users you'd like.

Lightning App Builder with the Donor Record Page selected from the Pages dropdown

Using the Integration

9

Sync Your First Record

Back on the Contact, Lead, or Account page, you'll now see the DonorAtlas component, which tells you whether this record has been synced with DonorAtlas. Click Sync with DonorAtlas to sync!

DonorAtlas component showing Not Synced Yet status
10

View Your Synced Record

The component will say “Pending” while it's loading. After a minute or so, the record will be synced! From here, you can open the DonorAtlas profile, re-sync the record (to update the information in Salesforce), un-sync (if DonorAtlas matched to the wrong donor), and view the underlying record in Salesforce.

DonorAtlas component showing a synced record with action buttons
11

Enable Batch Syncing

If you want to sync many Contacts, Leads, or Accounts at once, go to the Gear icon → Setup Object Manager Contact (or Lead, or Account) → List View Button Layout → Click the arrow on the “List View” row and click Edit → and under “Custom Buttons”, move “Sync with DonorAtlas” to the Selected Buttons.

List View Button Layout showing Sync with DonorAtlas in Selected Buttons
12

Sync Many Records at Once

Now, back on your Contacts list view, there is a new button called “Sync with DonorAtlas”. You can select many Contacts at once and click this to sync them all. Repeat for Leads and Accounts (Person Accounts) if you need.

Contacts list view with Sync with DonorAtlas button
13

Manage Your Integration in DonorAtlas

Back in DonorAtlas, notice the “Donors Synced with Salesforce” list in your team's Donor Lists, and the Salesforce integration listed under Team Details in your profile page (this is where admins can configure the integration).

DonorAtlas profile page showing Salesforce integration details
14

We're Here to Help!

As always, don't hesitate to request support if you have any trouble installing or using the integration, or if you just have suggestions for how we should improve it! Request support right from DonorAtlas.

Ready to enhance your
Salesforce CRM?

Contact Us