As its name suggests, NPSP is built specifically for nonprofits. It allows you to easily analyze your donor data (names, addresses, relationships, donation frequency, etc.) and maintain positive relations with your supporters. More than 27,000 nonprofits and educational institutes are using Salesforce NPSP.
To learn more about Salesforce NPSP, please start here. We recommend completing the quick Nonprofit Success Pack Workbook. If you want to dive deeper into NPSP, you can complete the comprehensive Salesforce Trailmix learning pack.
This manual will guide you through the simple integration process so that you can automatically sync all your Donorbox data with your Salesforce NPSP account. Here are the steps covered in this post:
- Step 1: Set Up Salesforce NPSP
- Step 2: Connect Donorbox and Salesforce
- Step 3: Map Donorbox Data to Salesforce Objects
- Step 4: Syncing Donorbox with Salesforce
- Donations in Salesforce
Step 1: Set Up Salesforce NPSP
New Salesforce User: Create a Salesforce NPSP Account
If your organization isn’t using Salesforce yet, it’s easy to sign up for Salesforce with NPSP 3.
- Go to salesforce.org/trial/npsp and submit the form to sign up for the “Lightning Enterprise Edition + the Nonprofit Success Pack (NPSP)”. Note: This creates a trial account that can be converted within the trial period to a permanent Salesforce NPSP Org. In this case, all the changes that you make to the trial Salesforce Org in the trial period are preserved. You can also opt for “Ultimate Edition + NPSP” but it does not have a trial version.
- Check your email for a confirmation email from . Confirm your account by setting a new password.
- Salesforce created the Power of Us program for nonprofit organizations and higher education institutions. They offer 10 free enterprise licenses, as well as discounts on additional Salesforce licenses, products, and/or services. Be sure to apply for the program at powerofus hub website.
Existing Salesforce User: Install NPSP
If you are already using Salesforce, you will need to install NPSP3 to your Salesforce Org. Please follow the steps outlined on Salesforce’s NPSP Install page.
Step 2: Connect Donorbox and Salesforce
- To begin the data integration, you first need to connect Donorbox with your Salesforce account. On your Donorbox Account page, click on “Salesforce Integration“.
- Click on “Connect with Salesforce”. It should prompt you to log in to your Salesforce account. Note: It’s important that you log in with a user that has sufficient access to your org. We advise using an admin account.
- Simply log in to Salesforce to connect your account. Note: Once you click the “Log In” button, Salesforce will verify your account through a verification code. After successful verification, it will ask you to allow access to Donorbox. Make sure you select the “Allow” button.
- After a successful connection, you will be redirected to the Salesforce Integration page in your Donorbox Account. It should now look like this:
Step 3: Map Donorbox Data to Salesforce Objects
Donorbox has some Standard Fields that you might want to include in Salesforce.
- On your Salesforce Integration page, in the right pane you will find “Data Mappings” section.
- From there, pick the Salesforce fields (in Contact, Account, and Opportunities) that you want this data to flow to. Note: Check out our detailed Data Mapping guide for more information on field mapping between Donorbox and Salesforce.
If you ask your donors additional questions on your Donorbox donation form, you may want to record their answers in Salesforce too. You can do this with Custom Fields.
- Head back to your Salesforce Integration page
- Scroll down to the Salesforce Fields section. In there, on the right you will see the “Campaign Specific Mappings” section. Click the edit icon in the right column of each campaign to get redirected to the custom question mappings page
- Just like the standard field mapping above, you can map the values of additional questions to standard or custom fields in your Salesforce objects
Step 4: Syncing Donorbox With Salesforce
Export Donorbox Data
Now that you have all your fields mapped, you are ready to export your donors, campaigns, and donations data to your Salesforce org.
Simply go to your Salesforce Integration page and click on the “Unexported Donations” button in the Export Data section.
In a few minutes, your donations, donors and campaigns should appear in your Salesforce org under Accounts, Contacts, Campaigns, and Opportunities.
Donorbox will automatically sync all your data. You don’t have to do a thing!
We all need a re-do sometimes. The “All Donations” button in the Export Data section deletes the existing donations from your Salesforce org and exports them again from your Donorbox account.
It’s important to note that this functionality does not remove and re-create the Accounts (Households) and Contacts from your Salesforce org.
The “Remove data from Salesforce” button removes all the donations (Opportunity records in Salesforce) that have been made by Donorbox.
Note: It does not remove the Accounts (Households) and Contacts that were created with the donations. This is because these Accounts and Contacts may now be linked to other records in Salesforce too. You can always delete them from within Salesforce if you don’t need them.
Donations in Salesforce
When a donation is made to your Donorbox campaign, it appears on the donations page for that particular campaign.
With the donation, the corresponding Contact, Account, and Campaign are also created in Salesforce.
- The Campaign name is the same as your Donorbox campaign name.
- The primary contact name is an amalgamation of the donor’s first name and last name, as given on your donation form.
- The Account (Household) name follows the Salesforce NPSP naming convention that you have selected in your NPSP household naming format.
1. How does Donorbox manage existing Salesforce Contacts and Accounts?
If you have existing Contacts and Accounts in Salesforce, no need to worry about data duplication. Donorbox checks existing Contact emails for de-duplication.
If a donation with the same first name, last name, and email comes in, we add the Opportunity to the existing Household Account and Contact.
If the email is the same, but the first name or last name differs, we create a new Contact under the same Household Account. The incoming donation is assigned to that newly created Contact.
Our integration takes a similar approach for donors who make recurring or multiple donations. For example: if a matching Account and Contact are found based on the first name, last name, and email in Salesforce, the incoming donation is tied to them in Salesforce.
2. How does Donorbox handle Salesforce Campaigns?
Whenever the first donation comes in for a campaign in Donorbox, our integration searches for the corresponding campaign in Salesforce. If a campaign with that exact name is found in Salesforce then we link the donations to that otherwise we create a new campaign in Salesforce.
Once a campaign has been created/identified in Salesforce, all the subsequent donations are added to it as they are made. The “Type” picklist field in the campaign record in Salesforce is set to “Donorbox”.
This is the default behavior but we also allow mapping of Donorbox campaign to any of the campaigns that are currently present in your Salesforce org. You can define this mapping by going to the Salesforce Integration page where you can assign a particular Salesforce campaign to a Donorbox campaign of your choice. Note: The Salesforce campaign dropdown is pre-populated with all the campaigns from your Salesforce org once you have connected your Salesforce account to Donorbox.
3. How does Donorbox manage recurring donations in Salesforce?
With recurring donations we provide the option to use the Standard NPSP Recurring Donations object model as well as the simple opportunities object for syncing recurring donations. Please reach out to our support if you would like to enable the sync with Salesforce NPSP Recurring Donations object. This feature has to be enabled by Donorbox support on demand otherwise by default recurring donations are synced as simple opportunities in Salesforce.
When a recurring donation is set up in Donorbox and the NPSP Recurring Donations usage is not enabled, we create a simple Opportunity record in Salesforce just like we do for one-time donations. If the Recurring Donations usage is enabled for your integration then a new recurring donation record is created in Salesforce against every new incoming recurring plan in Donorbox.
4. How is Salesforce updated when a donation is updated on Donorbox?
When a Donorbox donation is updated, the changes are also replicated in your Salesforce Org. The process is fairly straightforward unless the donor email is changed.
All the fields are updated in the Salesforce org based on the field mapping done for that Donorbox campaign. If the email is updated, we try to find the updated contact on Donorbox and in Salesforce using the updated email. If the contact is found based on the updated email, it is linked to this donation on Salesforce. Otherwise, a new Contact and Account are created for the updated donation.
If you have any questions, you can reach us at .