Read Virtuous CRM contacts and individuals, import contacts and gifts, and manage custom collections.
Explore 13 workflow actions for Virtuous CRM, including account permissions and operation limits.
7 read actions6 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Create a collection for a contact
Write
Adds an instance of a custom collection to a contact.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can create and edit contacts and gifts
Operation limits
A lost answer is never resent automatically: a second call would import the record again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a collection for an individual
Write
Adds an instance of a custom collection to an individual.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can create and edit contacts and gifts
Operation limits
A lost answer is never resent automatically: a second call would import the record again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a contact transaction
Write
Sends a contact through Virtuous's import process, which matches it to an existing contact or creates one (the result is not returned).
Permissions and limits
Account permissions
A Virtuous API key whose permission group can create and edit contacts and gifts
Operation limits
A lost answer is never resent automatically: a second call would import the record again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a gift transaction
Write
Records a gift (a donation already received elsewhere) through Virtuous's gift import, which matches the donor, recurring gift and designations. No money moves.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can create and edit contacts and gifts
Operation limits
A lost answer is never resent automatically: a second call would import the record again.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Find an individual by email
Read
Finds the individual in your Virtuous CRM that has this email address.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can read contacts
Get a contact
Read
Reads one contact with its individuals, address, giving totals, tags and custom fields.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can read contacts
Get a contact by reference
Read
Reads the contact linked to a record in another system, by that system's name and its ID.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can read contacts
Get an individual
Read
Reads one individual (a person within a contact) with contact methods and custom fields.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can read contacts
List contact custom collections
Read
Lists the custom collection definitions for contacts, with their fields.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can read contacts
List individual custom collections
Read
Lists the custom collection definitions for individuals, with their fields.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can read contacts
List individuals for a contact
Read
Lists the individuals (people) within a contact.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can read contacts
Update a collection for a contact
Write
Changes the fields of a custom collection instance on a contact.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can create and edit contacts and gifts
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a collection for an individual
Write
Changes the fields of a custom collection instance on an individual.
Permissions and limits
Account permissions
A Virtuous API key whose permission group can create and edit contacts and gifts
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Virtuous CRM. A saved workflow is not a completed provider action.