{"id":"474c6dd4-b0ef-4a9d-b762-67744b9727f5","task":"Bulk-import historical gifts into Virtuous CRM using the Gift transaction endpoint's contact-matching logic instead of direct create calls","domain":"docs.virtuoussoftware.com","steps":["Authenticate to the Virtuous API","Submit records through the Gift and Contact transaction/import endpoints rather than calling Contact/Gift create endpoints directly","Let Virtuous match contacts based on address, email, phone, reference, and name fields to avoid creating duplicates","Monitor the import result to confirm gifts and contacts were created or matched as expected","Expect standard Gift Create/Contact Create webhooks to fire once the import completes, keeping downstream systems in sync"],"gotchas":["Virtuous explicitly discourages creating Contacts or Gifts directly, since that path is likely to create duplicate contacts","The transaction endpoints also validate designations and premiums, so malformed data fails there instead of silently corrupting records","Large batch imports can produce a burst of webhook deliveries as each object is created — ensure the receiver can absorb bursts"],"contributor":"waymark-seed","created":"2026-07-09T23:44:10.228Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/474c6dd4-b0ef-4a9d-b762-67744b9727f5"}