PropFuel Connectors: How to Integrate PropFuel With Other Systems

Connectors allow you to connect PropFuel to an external system.  The primary use case is to add to and suppress people from PropFuel campaigns based on activity in your AMS.

PropFuel has more than 50 connectors and growing. See documentation for each connector. 

Installing and configuring a connector is a simple, two step process.  

• Step 1: Gather any necessary information. Depending on the system, we will ask for a few data points to connect or ask you to connect via OAuth to the external system. For system specific help, see the documentation for each connector.

• Step 2: Install your connector. Head to Settings -> Advanced -> Connectors.  All available connectors will be listed. Select the connector you want to configure, and click "Add". If you would like to connect with a system that is not listed, let us know, and we can look into adding it. 

After connecting your other system, you'll need to map your fields in PropFuel to fields in your outside system. Mappings are how we know what fields in your external system to store and where to put them in PropFuel.

You will need to map any fields that you would like to store in PropFuel for a contact. These fields and the data can later be used to trigger people into and out of campaigns, as well as pull in personalization for a contact, such as their organization or first name. 

To map fields, navigate to Settings -> Advanced -> Connectors -> Click "Edit" in your connector box -> Configure.  

On the left are all the fields in PropFuel you can map. On the right are drop-downs with all the fields available for mapping in your external system. You can select one (or more) fields from your external system to store in a corresponding field in PropFuel. If you select more than one field in the mapping a space will be added between them.

💡 If you need additional fields mapped that are not provided out-of-the-box in PropFuel, you can create custom fields to map. See instructions for creating custom fields. 

Looking at the "Creating a Segment" article, I can see it's comprehensive and well-structured. The "Using AMS Data to Enroll Contacts in Campaigns" article I wrote should reference this one for the detailed segment-building steps.

Here's the updated version that better aligns with the segment creation article:

Once your connector is installed and your fields are mapped, you can use AMS data to build Segments and enroll contacts in campaigns.

Building Segments with AMS Data

Segments allow you to build audiences using filters from your connected AMS, then add those audiences to campaigns with flexible sync behavior.

How It Works:

1. Build a Segment using AMS filters

   • Navigate to Segments and click Create Segment

   • In Step 2 (Add Contacts), click Add Filter Group

   • Select External Data Sources from the dropdown

   • Choose your connector (e.g., iMIS, Personify, MemberSuite)

   • Select the AMS field you want to filter by (e.g., membership status, renewal date, member type)

   • Choose an operator (is, is not, contains, etc.)

   • Enter or browse for the value you want to filter by

   • Click Save to add the filter to your group

2. Add the Segment to your campaign

   • Open your campaign and go to the Contacts tab

   • Click Add Segment and select your segment

   • Choose your sync behavior:

     • Sync: Contacts are enrolled as they meet the criteria and removed if they stop meeting the criteria

     • Add Only: Contacts are enrolled as they meet the criteria and stay enrolled even if they stop meeting the criteria

     • Fixed: Enrolls the current contacts in the segment at the moment you save, but does not add or remove contacts later

3. The segment syncs automatically

   • As your AMS data updates, the segment updates

   • Contacts are added to or removed from the campaign based on your sync behavior

Combining AMS Data with Other Filters

You can layer multiple filter types within the same segment to create more precise audiences:

• External Data Sources: AMS fields like membership status, renewal date, or event registration

• PropFuel Data: Contact fields, email status, segment activity, or signals

• Engagement Data: Campaign responses, question answers, or campaign enrollment status

Filters within the same group use AND logic (contacts must meet all conditions). Multiple groups use OR logic (contacts who meet any group's conditions are included).

Some connectors have actions available that allow you to write back data to your external system. Please see the documentation for your connector to see what write-back options are available.

Tokens are available to send response data along to other systems. Where available, click on the personalization card and select which information you would like to include.