Virtuous CRM basic integration

Set up Fundraise Up’s integration with Virtuous CRM.

If your organization has never connected Virtuous to Fundraise Up before, you'll only see the Virtuous G&C Import Write option in the Dashboard. The basic integration is no longer available for new connections.

Virtuous is a CRM platform built to help organizations manage their supporters. Fundraise Up offers two integration methods to connect with Virtuous:

  • Virtuous CRM (described in this article) offers a basic integration that syncs donation data to Virtuous in real time. However, it has several limitations that can impact data accuracy and flexibility.
  • Virtuous G&C Import Write is a more advanced integration that uses Virtuous’s Import Tool to give you greater control and flexibility. This is the recommended method for most organizations.

Limitations of the basic integration

 
Link copied

Before using the basic Virtuous integration, consider the following limitations:

  • Recurring plan changes aren't synced. Due to API limitations, Fundraise Up can’t send updates to recurring payment schedules. As a result, if you enable the Track payments option, a recurring donation may appear as Past Due even if payments are being made on time.
  • Supporter matching is automatic. Fundraise Up automatically matches donations to existing contacts using email, phone number, or address — depending on your integration settings. You can’t change this logic or customize the matching method. With G&C Import Write, you can use Virtuous’s Import Tool to manage duplicates more precisely.
  • Rate limits apply. The basic integration supports up to 1,500 requests per hour from a single IP address. High-volume organizations may see sync delays during peak donation periods.

How the basic integration works

 
Link copied

Here's how the basic Virtuous integration handles different types of data.

Recurring plans

 
Link copied

Recurring plans in Fundraise Up sync to Virtuous as Recurring Gifts. Each plan has a one-to-one match, and each installment syncs as part of that gift.

Virtuous doesn’t support recurring plans set to “Every 4 weeks.” These are synced as individual one-time donations.

When a recurring plan’s amount changes, or when a plan is canceled and later reactivated, Fundraise Up deletes and recreates the Recurring Gift in Virtuous. This keeps data consistent but may affect reports that rely on the original creation date of recurring gifts.

Contact matching and deduplication

 
Link copied

By default, the integration matches each donation to a contact in Virtuous using the email address provided at checkout. If a match is found, the donation is linked to that contact. If not, a new contact is created.

You can choose alternate matching logic, such as “name and address” or “name and phone number”. This is useful if your organization collects different types of contact information. To configure this, go to the General settings tab of the integration and select the Match contact option.

Settings for selecting the Match contact type

Refunded donations

 
Link copied

When you refund a donation in Fundraise Up, the integration updates the existing gift record in Virtuous instead of creating a separate refund. It changes the Gift Type to Reversing Transaction, keeping a clear audit trail.

Multiple currencies

 
Link copied

Virtuous supports multiple currencies and works with Fundraise Up’s multi-currency setup.

Donations sync in both the original currency and your account’s default currency. To display both values, use these mapping rules:

Fundraise Up propertyVirtuous property
donation → amountgift → amount
donation → currencygift → currencyCode

If you want to convert all donations into the default currency before syncing, use this setup instead:

Fundraise Up propertyVirtuous property
donation → converted amount ([account currency])gift → amount
account → default currency ([account currency])gift → currencyCode

Configure general settings

 
Link copied

You can control how the integration syncs data using several optional settings:

  • Sync test data: Sends test-mode donations to Virtuous. Use this to validate your mapping rules before syncing real data. Disabled by default.
  • Sync subaccounts: Appears only in parent accounts. When enabled, subaccount data syncs to Virtuous even if those subaccounts don’t have their own connection. Useful for chapter-based or federated organizations.
  • Track payments (in Virtuous CRM): Lets Virtuous generate a schedule of expected payments for recurring gifts. This helps monitor balances and identify missed payments. However, because the basic integration does not sync recurring plan updates, Virtuous may display inaccurate statuses.
  • Gifts are tax deductible: Marks all synced donations as tax-deductible in Virtuous. Enable this option if your organization classifies donations as tax-deductible for supporters.

General settings tab

  • Default project: Sets the default project for synced donations. Values are pulled from your Virtuous account.
  • Match contact: Controls how the integration identifies existing donors in Virtuous. You can choose from four options:
    • By email: Matches donors by email address only.
    • By email or name (default): Matches donors if either the email or name matches.
    • By email or address: Matches donors if either the email or physical address matches.
    • By email or phone: Matches donors if either the email or phone matches.
  • Supporter phone type: Defines which phone field in Virtuous is used for supporter records (for example, Mobile or Home).
  • Default segment: Sets the default segment for synced donations. Values are pulled from your Virtuous account.
  • Default comment: Adds a fixed comment that is always included with synced donations.

Set up mapping rules

 
Link copied

Mapping rules define how Fundraise Up data is written to Virtuous. You can map any supported Fundraise Up object and property to its counterpart in Virtuous. Default rules are provided, but you can edit or delete them as needed.

  • Example: Designation mapping
    Fundraise UpVirtuous
    Object: DesignationObject: Project
    Property: Designation codeProperty: Code
  • Example: Custom question mapping
    Fundraise UpVirtuous
    Object: Checkout questionObject: Contact custom fields
    Property: How did you learn about us?Property: How did you learn about us?

Mapping rules are configured in the Mapping rules tab of the integration.

Mapping rules tab

To add a mapping:

  1. Scroll to the bottom of the mapping rules table.
  2. Click Add rule.
  3. Select the Fundraise Up object (entity) and property (field) on the left.
  4. Select the corresponding Virtuous entity and field on the right.
  5. Save your changes.

Default mapping

 
Link copied

Some mappings are set by default and can’t be changed. These include:

Contacts → Household info

Virtuous propertyFundraise Up mapping behavior
Contact TypeSets this value to Household by default
NameCombines the supporter’s first and last name
On Behalf OfIf the Donate as organization option is used, sets this value as the organization name and changes Contact Type to Organization
Informal NameInserts the supporter’s first name
Primary Phone (Home Phone)Inserts the supporter’s phone number (if provided)
Primary Email (Home Email)Inserts the supporter’s email address
Address Line 1Inserts the first line of the supporter’s address (if provided)
Address Line 2Inserts the second line of the supporter’s address (if provided)
CityInserts the city from the supporter’s address (if provided)
State/Province/RegionInserts the state, province, or region from the supporter’s address (if provided)
Postal CodeInserts the postal code from the supporter’s address (if provided)
CountryInserts the country from the supporter’s address (if provided)

Gift → Gift details

Virtuous propertyFundraise Up mapping behavior
Gift TypeSets to Credit for card payments, Electronic Funds Transfer for bank payments, and Other for all other methods
Transaction IDInserts the donation ID
AmountInserts the donation amount
Gift dateInserts the donation success date
Receipt dateInserts the internal timestamp from the receiptSentAt field
PrivateWrites value from the Anonymous donation setting (true if selected; false is not)

Recurring Gift → Recurring Gift details

Virtuous propertyFundraise Up mapping behavior
AmountInserts the recurring donation amount
FrequencySets the frequency if it is Weekly, Bimonthly, Monthly, Quarterly, Semiannual, or Annual. If the frequency is Daily, Biweekly, or Every 4 weeks, syncs as a one-time donation
Start DateInserts the success date of the first donation
Next Payment DateInserts the next donation date
PrivateWrites value from the Anonymous donation setting (true if selected; false is not)

Configure special rules

 
Link copied

Special rules let you apply conditional logic — for example, syncing a specific value only when certain criteria are met.

These special rules use "if/then" logic: If X happens in Fundraise Up, map the value as Y in Virtuous. They’re useful for cases like campaign-based mapping.

For example:

  • If Campaign equals “Shelter” in Fundraise Up → set Project to “Shelter” in Virtuous.
  • If designation equals "Areas of Greatest Need" in Fundraise Up → set the segment in Virtuous to "General Giving Audience."

Special rules are configured in the Special rules tab of the integration.

To add a special rule:

  1. Go to the Special rules tab.

    Special rules tab

  2. Click Add Rule.
  3. Choose the Fundraise Up condition (IF) next to the Fundraise Up logo.
  4. Set the Virtuous mapping result (THEN) next to the Virtuous logo.
  5. Save your changes.

Sync settings

 
Link copied

You can control how records sync between Fundraise Up and Virtuous. Sync options are located at the bottom of the Virtuous integration page in your Dashboard.

Sync options

Manual sync

Use manual sync if you need more control over when and what data is synced:

  • Sync specific time ranges or your full donation history.
  • Update previously synced records after adjusting mapping rules.
  • Test your integration settings with controlled data transfers.
  • Make bulk corrections when fixing outdated field mappings.

Sync log

 
Link copied

The sync log provides a history of data sync activity between Fundraise Up and Virtuous. It shows which records were processed, whether they synced successfully, and any errors that occurred.

To view the sync log:

  1. Go to the Virtuous integration settings in your Dashboard.
  2. Scroll to the Synced donations section.

Synced donations section

Each log entry includes:

  • The time and date of the sync.
  • Records that were processed.
  • Success or failure status.
  • Error messages, if any — helpful for troubleshooting.
  • A button to resync individual records if needed.

Troubleshooting

 
Link copied

If you experience issues with the Virtuous integration:

  • Check the sync log for error messages and failed sync attempts.
  • Review your mapping rules to confirm that all required fields are configured correctly. Understanding Virtuous Mapping Rules in Fundraise Up →
  • Check for recurring plan discrepancies if you’re using Virtuous’s Track payments option. The basic integration does not sync schedule changes for recurring plans, which may cause the schedule in Virtuous to fall out of sync over time.
  • Review your organization’s email preferences if supporter records in Virtuous are showing as opted out. Why does Fundraise Up Virtuous integration always opt-out contacts from email →
  • Confirm your rate limits. The Virtuous API allows up to 1,500 requests per hour per IP address. Exceeding this may result in sync delays or failures.

For persistent issues, contact Fundraise Up support with your sync log details.

 

In this article