Add or Update Supporters

Actions that add or update Supporters in Engage must use one of three fields to determine whether a supporter already exists in your account: Supporter ID, External ID, and Email Address. Use the field that is available in your source application to link to the Engage value.

Supporter ID 

Supporter ID is the unique ID assigned to every supporter created in Salsa Engage. In order for this field to be used, the supporter must already exist, so that the ID is known.

External ID

When your other application creates a record, it generates a unique ID of its own to every supporter, called the External ID. This ID does not have to exist in Salsa Engage to be used. When this ID is used in the integration, Zapier will either update an existing supporter with the matching ID or create a new supporter if the ID is not found.

Email Address

When an Email Address is used in the integration, Zapier will either update an existing supporter with the matching Email Address or create a new supporter if the Email Address is not found. If more than one supporter is found with the matching Email Address (Salsa CRM users only), then it will choose the record that was created first.

Search Hierarchy

Salsa will look at the Supporter ID value first to see if there’s a match. If one is found, it will update the record, this includes updating the External ID and Email Address fields if any change is made.

If Supporter ID is not provided, Salsa will search for a match on either External ID or Email Address if both are provided. If a match is found for either External ID or Email Address, it will update the matching record.

NOTE: the integration will not accept a duplicate External ID or duplicate Email Address and will issue an error if either submitted value is already stored with another supporter record. 

Add Charges or Refunds

Salsa’s integration with Zapier requires that the source application sends whether it is a successful charge or a refund. When setting up your zap, you must choose either Charge or Refund action.

In order for either a charge or a refund to be stored in Salsa, you will need to set up two zaps: one for charges and one for refunds. For each, set a filter that sends data only if the donation contains the appropriate type of update.

For example, your source application has a field called "Donation Status" and a status of "Success", which means the donation was successful. Similarly, a "Donation Status" of "Refunded" means that the donation was refunded. To configure the successful donation zap correctly in this hypothetical situation, you would add a filter on the "Donation Status" field where the field "Exactly Matches" a value of "Success." Then, when configuring the Salsa action, you would set the Donation Type to Charge. To configure the refunded donation zap, you add a filter on the "Donation Status" field where the field "Exactly Matches" a value of "Refunded."

Turn on both zaps and Zapier will send any successful donations to Salsa as a Charge and any refunds as a Refund.

Add Supporters to Groups

The Add Supporter to Group in Salsa Engage action requires linking the Supporter ID. If your source application stores the Supporter ID...

1. Choose the App & Event.
2. Choose the Account.
3. Choose the Group name.
4. Choose the Supporter ID field from your source application.
5. Click Done Editing to finish.
   

If your source application doesn’t store the Supporter ID...

1. Create a multi-step zap that first performs either the Create or Update Supporter or Create or Update Donation and Supporter action.
2. Add the Add Supporter to Group in Salsa Engage action in the second action of the zap. The steps to construct this action are above.
3. Map the Supporter ID provided by the first action.

Map Funds, Campaigns, and Appeals

Salsa CRM users can optionally map Fund Campaign, or Appeal values for donations submitted through Zapier to the Create or Update Transactions or Create or Update Donation and Supporter actions. The Fund, Campaign, and Appeal values must pre-exist in the CRM before sent through Zapier. If no Fund is mapped, Salsa CRM will add all donations to the Salsa Engage Default Fund.

Map Custom Fields

Optionally map custom information about supporters to Supporter Custom Fields or custom donation information to Activity Custom Fields. Here’s a brief overview of the difference between the two fields:

• Supporter Custom Fields—Used for non-standard supporter data such as favorite color, parent (this could be a yes/no field), How did you hear about us? (this could be a drop down of options/"Single Choice" field), etc. Supporter custom fields can be synced with Salsa CRM.
• Activity Custom Fields—Used for particular data points tied to a donation, such as a Gift Memo. They are transactional. When submitted through Zapier, they will be attached to the donation record and not directly to the supporter. Salsa supports Activity Custom Fields for all activity types, but currently donation activities can only be submitted through Zapier.

To map data to custom fields,

1. Copy the name of the custom field, such as Dietary Restriction, from Salsa Engage.
   
2. Paste the name of the field into the first text input.
   
3. Then map the field from your source application by selecting it from the list.
   
4. Use the plus button on the right under the current mapping to add more custom field mappings.