Salesforce Marketing Cloud: ExactTarget Connector 


In this Article
Related Articles

With FormAssembly's ExactTarget/Salesforce Marketing Cloud Connector you can easily create subscribers, assign subscribers to lists, and send information to your custom data extensions.


Connector Timeline

To begin using the connector, select the form you would like to use, go to the connectors page and select the ExactTarget connector for the Form Submitted or After Form Submitted section of the timeline:

Next, click on configure to begin configuring the connector. You'll also want to make sure the connector is set to enabled once you enter the configuration screen.


Manually Connecting to ExactTarget

In order to manually connect to ExactTarget you will need a "client ID" and a "client secret."  To acquire these credentials, you will need to login to the ExactTarget App Center.

Once you have logged in to the App Center, click the blue create a new app button at the top right of the screen and then choose API Integration:

Next, you will need to enter in a name, description, and package. These can be whatever you would like, then click next.

For step 2, choose your ExactTarget account to integrate with and click next again.

For step 3, data access, you will need to give read and write permission to lists and subscribers and audiences (located under contacts), and data extensions and file locations (located under data). Then click next for steps 3 and 4.

You should now be able to see your client ID and client secret under the authentication and integration section of the overview page:

Copy and paste those two values into your ExactTarget connection parameters in FormAssembly, click save, and you'll be ready to go!

Note: If you see a blank for an "application signature" you do not need to complete that field.

Configuring the Connector

Now that you have made the connection between FormAssembly and ExactTarget, you're ready to begin configuring your connector.

You can start by clicking on Add your first object and choosing whether you'll be creating or updating a record in ExactTarget. You can also select if you'll be working with a subscriber or a custom data extension.

Note: If you are not seeing any options after you select create or update, try saving and refreshing the page.

Subscribing and Unsubscribing from Lists

If you're working with a subscriber you can also choose which (if any) list you would like to subscribe them to or unsubscribe them from.  It is important to note that lists are only available for subscribers, and not for data extensions.

You can choose to subscribe or unsubscribe your respondents to a single or multiple lists, based on their selection in the form, or based on other criteria that you decide.

First, click on "Subscribe to..." or "Unsubscribe from..." depending on which you would like to set up. From there, select the list that you will be subscribing them to or unsubscribing them from, and determine what criteria should be used to trigger that event.  

In the example below, the user would be subscribed to the "Veer West List" when "Weekly" is selected in a radio button field:

You can choose to setup subscribers when a particular choice in your form is or is not selected, and you can also use our formula editor to set up more complex subscription rules as well.

To setup multiple subscription or unsubscription rules, simple click the "Subscribe to..." or "Unsubscribe from..." button again, and you can setup as many rules as you would like.

Field Mapping

Finally, you'll need to map your fields from FormAssembly to ExactTarget so that the connector knows what information to send and where to send it. Simply select the FormAssembly fields on the left and the ExactTarget fields on the right. You can also insert text and formulas here if you would like to.

When you've finished mapping all your fields, click save and you're ready to begin testing!


Updating a Record

If you want to update a subscriber or custom data extension, or add a subscriber to a second list, you will choose Update instead of create.

Once you have selected "Update" you will see that you need to setup how the connector will find your existing record under the "Matching with" section. From here, you can choose what field(s) from ExactTarget will match with fields in your form. It is recommended that you use a field that will be completely unique for each record, such as the email address.

After you have completed setting up your look up, you can also map any additional fields that you would like to.

This is also how you would add a subscriber to additional lists, by selecting which list you would also like them to be on. Adding a new list in an update will not change any lists they are currently on, it will only add them to the new list.


Video Tutorial

This video is designed to walk you through the beginning steps of connecting to Salesforce Marketing Cloud, and creating, updating, and prefilling records.



Embedding Forms in Cloud Pages

Terms of Service · Privacy Policy