<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=2191750074375425&amp;ev=PageView&amp;noscript=1">
Skip to content
More support
Contact us
  • There are no suggestions because the search field is empty.

Troubleshooting a Failing Virtuous Sync

Why is a Virtuous sync failing?

A Virtuous sync can fail when the BetterUnite integration is not connected, the campaign is not mapped correctly, scheduled sync settings are not enabled, or a Virtuous segment or project designation is no longer available. Checking the integration status, sync history, and current mappings usually identifies where the sync is breaking.

How do you troubleshoot a Virtuous sync?

  1. Go to Settings → Integrations → Virtuous → Manage and confirm the Virtuous connection is established.
  2. Open the affected campaign mapping and confirm it is mapped to a Virtuous segment.
  3. If you use scheduled syncing, make sure:
    • Enable Sync Schedule is turned on
    • At least one run time is selected
    • The scheduled time has passed
    • The gift is a recent unsynced donation from the last 30 days
  4. Check the Virtuous Integration page for job status and history.
  5. Open any error details shown for the sync run.
  6. If BetterUnite shows the gift as transferred, complete the import in Virtuous:
    • Go to Data Management → Gift Transactions
    • Select the transferred transactions
    • Create a bundle
    • Review it
    • Import the bundle to create the gift records

What does a 404 error mean?

A 404 Not Found response indicates the sync request did not complete because a required Virtuous record was not available. In troubleshooting, this has been linked to:

  • a previously mapped segment no longer being available in Virtuous
  • a project designation mapping pointing to a deleted or unavailable project

What should you check if the segment or project mapping is failing?

  1. Reopen the campaign mapping and confirm the selected Virtuous path is set at the Campaign → Communication → Segment level.
  2. Review any campaign-specific designation settings.
  3. If needed, re-save the item so the Virtuous mapping inherits from the campaign again.
  4. Check project designation mappings and select an existing project.
  5. Run the sync again and review the job history for the latest error details.

 

Conclusion

For Virtuous sync issues, start with the integration connection, campaign mapping, schedule settings, and sync history. If you see a 404 error, check for missing segment or project designation mappings and retry the sync after updating the mapping.