How Donorbox Form Fields Are Mapped to Your Salesforce Account

  • Donorbox provides extensive integration with Salesforce for nonprofits, including both Nonprofit Success Pack and Nonprofit Cloud
  • It is important to understand how your Donorbox form fields are mapped to your Salesforce account
  • Briefly touched upon this data mapping in our Salesforce integration guide
  • Data mapping guide, we’ll cover all aspects of Donorbox-to-Salesforce field mapping
  • Designed our Salesforce integration to handle auto-mapping of the essential fields and give you the ability
  • Topic area: Donor Management, Donorbox Integrations, Donorbox Product Updates, Salesforce
Written by: Zarq | Reviewed by: Colin Grist
How Donorbox Form Fields Are Mapped to Your Salesforce Account
Subscribe to our e-newsletter to receive the latest blogs, news, and more in your inbox.
❤ Join the fundraising movement!
Subscribe to our e-newsletter to receive the latest blogs, news, and more in your inbox.
Add us as a preferred source on Google

Donorbox provides extensive integration with Salesforce for nonprofits, including both Nonprofit Success Pack and Nonprofit Cloud.

In order to fully utilize the features of this integration, it is important to understand how your Donorbox form fields are mapped to your Salesforce account when you enable this integration. We briefly touched upon this data mapping in our Salesforce integration guide.

In this data mapping guide, we’ll cover all aspects of Donorbox-to-Salesforce field mapping. We designed our Salesforce integration to handle auto-mapping of the essential fields and give you the ability to configure your custom and optional fields as needed. 

With that in mind, our field mapping can be divided into three sections:

  1. Standard system-mapped fields
  2. Additional data point fields are optional and have to be configured by the user
  3. Custom (campaign-specific) fields that can be configured by the user

Standard System Mapped Fields

One thing before we begin with the field mapping – Donorbox pushes a new campaign to Salesforce only when a donation arrives. So if you have created a campaign on Donorbox and are wondering why it’s not showing up in your Salesforce account just yet, don’t worry – your data will appear shortly after you receive your first donation. 

Nonprofit Cloud Users:
Please follow this guide here if you wish to enable the optional gift objects feature to create gift transactions, gift commitments, and gift commitment schedules from Donorbox to Salesforce.

Nonprofit Success Pack Users:
Donorbox uses these four Salesforce objects in our integration:

  • Campaigns
  • Accounts
  • Contacts
  • Opportunity

This guide will use the following campaign to help you understand our field mappings:

Screenshot shows a donation form for a Donorbox campaign that will be mapped to Salesforce.

When the first donation to this campaign is made, Donorbox pushes the data to the connected Salesforce account.

First, the integration checks if that particular campaign is present in Salesforce. If it’s not present, a new campaign is created in Salesforce and the donation is pushed after that.

The integration checks whether any campaign fields have been updated once it locates your campaign. If the campaign fields have been updated, the corresponding Salesforce campaign is updated before the donation data is pushed to Salesforce. 


Campaign

Our integration uses the following fields in the Salesforce campaign object:

  • Campaign Name
  • Type
  • Status
  • Active
  • Campaign Currency
  • Start Date

Note: The above fields are the ones that are visible to you on your campaign details page on Salesforce. In the background, our integration also uses other standard Salesforce fields like ID.

These fields are essential for maintaining the identity and synchronization between Salesforce and Donorbox. When the campaign is pushed to Salesforce, the above fields are populated based on the values that are present in your Donorbox campaign.

Salesforce Data Mapping Guide

The Campaign Currency field in Salesforce is a managed picklist. It contains the Currency ISO codes for the currencies that you have enabled for your organization. By default, every Salesforce Org has one currency.

If your Donorbox campaign uses the same currency, there is no need for multiple currencies in Salesforce. If this is not the case, then you need to enable multiple currencies in your org. Here is an article to help you set it up in your Salesforce account.


Accounts

In Salesforce Nonprofit Success Pack, there are two standard record types: “Organization” and “Household Account”. In Nonprofit Cloud, there is an additional “Person” record type. 

When a new account is created in Salesforce for a contact through the Donorbox sync, the “Household Account” record type is selected. Most of the account management in Salesforce is done based on contact information.

To learn more about how we manage accounts and contacts and avoid duplicates, check out our integration blog post.


Contacts

All the contact information collected from your Donorbox donation form is used to create a new contact and the corresponding account for that donor. We also check if a donor already exists in Salesforce with the provided contact information – if so, we use that instead.

Donorbox uses the following Salesforce contact fields:

Donorbox Donor FieldSalesforce Contact Field
First NameFirst Name
Last NameLast Name
Address 1 + Address 2 Mailing Street
CityMailing City
Zip CodeMailing Postal Code
Phone Phone
EmailEmail
StateMailing State Code
CountryMailing Country Code

When a new donation arrives, this is what a Donorbox-created contact looks like in Salesforce:

Salesforce Data Mapping Guide for nonprofits

Nonprofit Salesforce Data Mapping Guide

Salesforce Data Mapping Guide


Opportunity

Donorbox donations go into the Opportunity object in Salesforce.

An Opportunity record is created at the end when the campaign, account, and contact records needed for this opportunity record have all been created or have been identified.

Our default donation push uses the following Salesforce opportunity record fields:

Donorbox Donation FieldSalesforce Opportunity Field
AmountAmount
Donation DateCloseDate
CommentDescription
Opportunity NameOpportunity Name
Account NameAccount Name
Primary ContactPrimary Contact
StageStage
CurrencyCurrencyIsoCode
SF Campaign IDPrimary Campaign Source

From all of the above fields, the Stage field can be configured in Donorbox from the Salesforce Data Mapping page. By default, the value for the stage field is “Closed Won”. Using all this information from the Donorbox form, this Opportunity is created inside Salesforce:

Salesforce Data Mapping Guide


Additional data point fields are optional and have to be configured by the user

The following article explains what value is contained in each of the fields that you see on the Salesforce Data Mapping page in Donorbox. All of these fields can be mapped to any custom fields that are present in the Account, Contact, and Opportunity objects in your Salesforce org.

 

We also ensure that the fields that you see in the drop-downs on the mapping page are up-to-date. So whenever you add a new field in any of these three objects in your Salesforce org, we update our drop-downs accordingly too. Please note, this does take about 30 minutes to an 1 hour to populate on the drop-down menu.


Custom (Campaign-specific) fields that can be configured by the user

Donorbox has a powerful form builder that allows you to add custom questions to your campaign form. Along with the standard fields, Donorbox gives you the capability to map these additional questions to your Salesforce fields.

A more detailed look at how you can map these campaign-specific additional questions to Salesforce can be found in our integration blog post. Note that the ability to map additional questions will only appear if you’ve added additional questions to your form. 


Conclusion

The Donorbox + Salesforce integration combines two powerful tools to help nonprofits of all sizes fundraise, forecast, and grow! We hope this article’s detailed look at these data mappings helps your organization customize your Salesforce integration to streamline your workflow as much as possible.

If you still have any questions, please feel free to reach out to us at .

Avatar photo

Product Manager - Integrations @ Donorbox

  • facebook
  • twitter
  • instagram
  • linkedin
  • url
Subscribe to our e-newsletter to receive the latest blogs, news, and more in your inbox.
❤ Join the fundraising movement!
Subscribe to our e-newsletter to receive the latest blogs, news, and more in your inbox.

Take your donor experience to the next level!
Join the 100,000+ nonprofits already raising funds online.