Skip to main content

Virtuous Integration & Setup Guide

Learn how to configure the Virtuous Integration to sync your grant-tracking data from Instrumentl to your donor management system

Written by Rebecca Huber
Updated over a week ago

With Instrumentl's Virtuous Integration, you can take your fundraising efforts to the next level. Keep all your key grants info in one place with this one-way sync:

  • Sync your grants information and cultivate a more holistic approach to fundraising

  • Easily enhance collaboration & grow your team's giving & donor efforts

  • Keep your colleagues who aren't on your Instrumentl account in the loop, and streamline your entire team's grants strategy.

Note: Virtuous Integration is available on our Professional Plan, Advanced Plan, University Plan, and Custom Enterprise Plans.


Setup Instructions

Getting up and running with Virtuous integration is a quick and easy four-step process! As an overview, you’ll take the following steps:

Step 1: Enable integration

1. To enable your integration, you need an API key. Copy your API key under the Settings menu in Virtuous:

2. Once you have the API key copied, sign in to Instrumentl.

3. Go to Account > Integrations in the bottom-left corner of your screen.

4. Select Login to Virtuous:

5. Paste in your API key in the corresponding field and then click Authorize.


Once you've successfully connected to your Virtuous account, select Next.

Step 2: Map Opportunity Data

After authorizing Virtuous, the next step is Map Opportunity Data, where you:

  • Configure your Opportunity Name

  • Map each Opportunity Status

  • Toggle Opportunity Notes - optional

  • Toggle Custom Fields - optional


When finished, select Next at the bottom of your screen.

Step 3: Map Funder Data

The last step to configure your Virtuous Integration is Map Funder Data, where you:

  • Add placeholders for Contact Individuals

  • Toggle Sync Key People β€” optional

  • Map Funder Notes

  • Toggle Custom Fields β€” optional

After this step, you will have successfully enabled your Virtuous Integration! πŸŽ‰

Note: For more details on mapping fields from Instrumentl to Virtuous & field names, you may refer to our Help Center article on Mappable Virtuous Fields.

Step 4: Sync Data to Virtuous

Now that your Virtuous Integration is configured, it's time to sync your data! In your Tracker, open any saved grant and click Sync to Virtuous in the bottom-right corner.

  • Select existing contact, or select the Create New Contact from dropdown.

    • If you selected existing, select the grant.

  • Click on the Confirm button and wait until you see the 'Synced to Virtuous' label.

β†’

Once an opportunity is synced, changes you make in Instrumentl will automatically update the mapped fields in Virtuous, saving you time and giving you peace of mind.


FAQs

If you're looking for more information on mapping Instrumentl field names to Virtuous fields, see our article on Mappable Virtuous Fields.

πŸ”— Mappable Information

Which types of records can I link?

Users can link Saved Grants to Opportunities and Funders to Constituents.

What about my Funder and Opportunity Notes in Instrumentl?

Virtuous supports syncing neither Instrumentl Opportunity nor Funder Notes to their Grants object. While it is optional, you can sync both Funder Notes and Opportunity Notes in the Field Mappings section to Contact Notes in Virtuous.

Can I map Tasks to Virtuous?

No, tasks cannot be mapped to Virtuous at this time. The Virtuous API currently does not support updates to tasks after they've been created.

Can I map the Expected Notification Date?

Yes, you can map Instrumentl's Expected Notification Date field!

How do I map Custom Fields?

Custom Fields in Instrumentl can only be synced to custom fields in Virtuous. You'll just need to create a custom field in Virtuous with the same name to map to it.

Can I disable any field mappings? If so, which ones?

Yes! Currently, Opportunity Notes is the only field mapping you can disable in the Virtuous integration. Simply toggle the switch to the right of the name to prevent it from being synced in the future. (There are more field mappings to come!)

➑️ Syncing & Updates

Do existing opportunities sync, or only those created after the integration setup?

  • The integration does not automatically transfer any data to Virtuous upon activation. Instead, data begins to sync only when you manually link an opportunity in Instrumentl to a corresponding opportunity in Virtuous.

  • This approach gives you complete control over which data is synchronized, ensuring that your Virtuous account remains organized and free of unwanted entries.

Are changes automatically synced to Virtuous? How often?

  • Yes β€” changes are automatically synced from Instrumentl to Virtuous whenever a change is made to a record in Instrumentl to which the field is mapped.

  • The updates are immediate. This ensures that your data remains consistently up-to-date across both platforms.

How does syncing from Instrumentl affect the information currently stored in the mapped Virtuous field?

Changes are synchronized one-way from Instrumentl to Virtuous. Any changes made will overwrite any values in Virtuous, regardless of when those updates were made.


Contact Us

Have any questions about our Virtuous Integration? Reach out to our friendly Support team via the chat bubble when logged into your account, or email us at hello@instrumentl.com.

Did this answer your question?