Contents

Overview

The Integration for Salsa and Gravity Forms plugin automatically sends constituent data from Gravity Forms created and managed in WordPress into a designated Salsa system. You can choose what data to send to Salsa and what fields the data should go into on a form-by-form basis.

General Mapping

Mapping Gravity Forms fields to Salsa fields needs to be done on a form-by-form basis. First, create a new form by following this Gravity Forms guide.

For each form that you want to connect Salsa, you must manually map fields, so the Form know where to send - or not to send - all information collected.

To create an API connection:

  • From the lefthand navigation menu, navigate to Forms
  • From the list of forms, hover over the form you want to connect with Salsa, hover over Settings, then click on Salsa API 
  • This screen will identify if a connection has been created for this form. If no connection has been set up, the screen will look like this:

  • Click on the Add New button or the link for Create one 
  • First, you’ll need to name the API Feed. By default, it will label it Salsa API Feed [x]. X being the number of feeds you have on the site. 
  • Map the fields from your form to the corresponding Salsa field. The left column contains a list of all fields -- standard and custom -- in Salsa. The right side dropdowns contain a list of all fields on your specific form. Gravity Forms will attempt to automatically map the fields that it can identify.

  • Note that Email must be mapped - this is Salsa’s main way of tracking supporter records. 
  • In addition to the standard fields that users are entering on the forms, there is additional tracking information that the form is collecting that can also be sent over to Salsa, including: 

  • You can also select one or more specific groups from Salsa that users will be added to. This list is generated directly from your Salsa system.

  • Once everything is configured, click the blue button for Update Settings to save your connection. Data will start flowing to Salsa as users complete this form.

Conditional Logic

The feeds also contain a setting for conditional logic:

Conditional logic allows you to set up a feed to only send data to Salsa under certain conditions. For example, you may want users who select a certain interest on a form to be assigned to one group, and users who select a different interest to go to a different group. Using conditional logic, you can set up multiple Salsa feeds and set them only to process under certain conditions.

In this example, we have a field called Events where users can select if they're interested in Spring, Summer, Fall, or Winter events: 

I want users to be added to corresponding group(s) in Salsa depending on which season(s) they select. To do this, I'll need to create 4 separate feeds, then use conditional logic to indicate which feeds should be processed when.

  • From the list of forms, hover over the form you want to connect with Salsa, hover over Settings, then click on Salsa API
  • Click Add New to create a new feed
  • Give your new feed an appropriate name, like "Summer Events"
  • Map your fields as noted above
  • In this example, I'm checking the box for the group for Summer Events because this will be my feed for people who chose that option
  • At the bottom of the screen, enable the checkbox for Conditional Logic: Enable Condition. A new set of options will appear.
  • For Process this feed..., you can choose:
    • Any - The data will be sent to Salsa per the mapping in this feed if any of the conditions you set in the next step match
    • All - The data will be sent to Salsa per the mapping in this feed only if all of the conditions you set in the next step match
  • Choose the first field and items for the condition. In this example, this feed will process to Salsa if a user selected "Summer" for Events.
  • You can add additional fields using the plus sign

  • Click Update Settings to save your changes
  • Add an additional feed for each of your other conditions
  • In my example, I have four feeds, each with a condition for a different season for the events field
  • Each feed will only process and send data to Salsa if it meets the condition that I set for it

Tags

You can also add tags to supporters who fill out specific forms. To add tags:

  • Go to the Form Editor for the form you would like to add tags for 
  • On the right side, click Hidden to add a Hidden field 
  • Click on the new field to edit it 
  • Change the field name to Tag (or some other useful term) 
  • Click the advanced tab
  • In the Default Value field, enter the name of the Tag you wish to add to any supporter who fills out this form:

  • Click Update to save your changes 
  • Go to Form Settings > Salsa API and add/edit a Salsa feed 
  • For the Tags mapping, select “Tag” (or whatever label you chose earlier) from the drop-down menu

In this example, users who fill out this form will have the tag "Events" added to their supporter record in Salsa.