RD Station: Retrieve and Export data via REST API

Ion integrates seamlessly with RD Station via their REST API. Ion’s RD Station integration enables you to add contacts to RD Station in real time.

Before we begin

There are a few items you’ll need to roundup from RD Station prior to setting up the integration, listed below:

A private app needs to be created in RD Station in order to generate the REST API details. 

  • RD Station Client ID
  • RD Station Client Secret

Please find steps below to generate these details within RD Station. Should you need additional guidance with the steps below, please reach out to RD Station support.

  1. Log into RD Station App Store
  2. Click “Create App” button
  3. Give your app a name, select a category, and check the boxes for the languages you would like to support.
  4. For the callback URL, use the below, but replace the bold part of the URL with your Ion console’s URL. Please note that the actual client ID value will replace the xxxxx placeholder in step 8.
    1. https://yourcompany.postclickmarketing.com/Admin/Integration/RDStationAccounts/HandleCallback?clientid=xxxxx
  5. Click “Save and next” button
  6. The next screen will show you your app’s Client ID, Client Secret and the Callback URL. Copy both the Client ID and Client Secret values from this screen and save them in a separate document for later.
  7. Click next
  8. Edit your app’s information and replace the placeholder clientID value (xxxxx) with the Client ID value that you copied.
  9. Save

There are a few items you’ll need to have ready in Ion prior to setting up the integration, listed below:

Check out the “Before you begin” support post for guidance in creating these items.

  • Create data collection fields
  • Create ion form(s)
  • Set-up testing creative

Let’s Get Started!

1. Add RD Station account credentials to Ion

  1. Click the Integrations tab in your Ion console’s side nav
  2. Click “Set up account credentials” toward the top of the screen
  3. Under “RD Station”, click “New RD Station credential”
  4. Add a friendly label for your account, then enter your RD Station Client ID and RD Station Secret
  5. Save

2. Create field mapping

Taking the steps below will map your Ion data collection fields to their corresponding RD Station API field names. To get started, add a new field mapping:

  1. Navigate into the Integrations screen
  2. Click green “New field mapping” button
  3. Label the field mapping and optionally add a description
  4. From the Integration type menu, select “RD Station”
  5. Save

3. Add Outbound fields to field mapping

Outbound fields define the data you extend from Ion to RD Station.

  1. Click green “New outbound field” button
  2. Add a field by selecting the field type from the source dropdown
    • To add a form field, hidden field or query string variable, select “Data field” and pick the data field category then data collection field
    • OR, to add an Ion Core field, select Core Field then pick the field you seek to include
    • OR, to export multiple Ion fields to one external field, pick Mashup and plug {% raw %} {{DataName1}}{% endraw %} {% raw %}{{DataName2}}{% endraw %}, etc. into the editor
    • OR, to reformat a value prior to export, pick Javascript code and add logic around the value collected in Ion. To access data collection fields via Javascript, use respondent.dataname.
  3. Optionally make your field required to run the integration
  4. Optionally add a default value
  5. Select the RD Station field from the drop-down menu of your RD Station API field names
  6. Save
  7. Repeat these steps for each field that should be included in the Field Mapping
  8. Skip adding Inbound fields

*IMPORTANT: RD Station requires an email address to be included for the integration to be successful. Please make sure you include an email address field in your field mapping to meet this RD Station requirement.

4. Create integration

  1. Navigate back to your Integrations screen
  2. Click into the Integrations tab
  3. Click green “New integration” button
  4. Enter label
  5. Optionally add a description
  6. Select the Field Mapping you’ve just created
  7. Set maximum retries
    • If there is a service interruption with the external platform, Ion will retry the post on the top of the hour for as many retries as you indicate here.
  8. Select Add Lead as the API method
  9. Optionally add yourself to the debug distribution list for testing
    • This will deliver an email to the designated address when the integration runs that displays the request and response from RD Station

5. Add integration to Ion pages

The Ion platform runs the integration based on rules you create. Rules can be added to any actionable item in your Ion creative. Integration rules are typically run at the form-level, upon form submission, or on an assessment step. Follow the steps below to add the integration to your Ion pages.

  1. Navigate into the creative
  2. Click on the form, button or link you seek to make the trigger to run your integration
  3. In Creative Studio, click on +rules
  4. Select the condition that needs to be met to run the integration
    • “No conditions required” is typically used
  5. Select “Run integration” then select your RD Station integration as the action
  6. Save

6. Test integration

To test your integration, use the creative you set up prior to beginning the integration steps. Please note, integrations do not run in Preview Mode so you’ll want to open a URL for testing. The integration will run once you submit the Ion form, or complete the action that runs the integration rule. If you’re on the debug email distribution list, you’ll receive an email that displays the data you transferred and response from RD Station. You’ll also want to verify success by ensuring the lead was created in your RD Station instance.

Get data via REST API

You can leverage Ion’s Get Lead integration with the RD Station REST API to optimize your Ion experiences. This integration enables you to retrieve data from RD Station using the respondent’s email address. You can leverage Get Lead to pre-populate (or shorten) Ion forms, auto-segment respondents and for progressive profiling.

Before we begin

There are a few items you’ll need to roundup from RD Station prior to setting up the integration, listed below:

A private app needs to be created in RD Station in order to generate the REST API details. 

  • RD Station Client ID
  • RD Station Client Secret

Please find steps below to generate these details within RD Station. Should you need additional guidance with the steps below, please reach out to RD Station support.

  1. Log into RD Station App Store
  2. Click “Create App” button
  3. Give your app a name, select a category, and check the boxes for the languages you would like to support.
  4. For the callback URL, use the below, but replace the bold part of the URL with your Ion console’s URL. Please note that the actual client ID value will replace the xxxxx placeholder in step 8.
    1. https://yourcompany.postclickmarketing.com/Admin/Integration/RDStationAccounts/HandleCallback?clientid=xxxxx
  5. Click “Save and next” button
  6. The next screen will show you your app’s Client ID, Client Secret and the Callback URL. Copy both the Client ID and Client Secret values from this screen and save them in a separate document for later.
  7. Click next
  8. Edit your app’s information and replace the placeholder clientID value (xxxxx) with the Client ID value that you copied.
  9. Save

There are a few items you’ll need to have ready in Ion prior to setting up the integration, listed below:

Check out the “Before you begin” support post for guidance in creating these items.

  • Create data collection fields
  • Create ion form(s)
  • Set-up testing creative

Let’s Get Started!

1. Add RD Station account credentials to Ion

  1. Click the Integrations tab in your Ion console’s side nav
  2. Click “Set up account credentials” toward the top of the screen
  3. Under “RD Station”, click “New RD Station credential”
  4. Add a friendly label for your account, then enter your RD Station Client ID and RD Station Secret
  5. Save

2. Create field mapping

Taking the steps below will enable you to extend the respondent’s email address to RD Station and map the data points returned to their corresponding Ion data collection fields. To get started, add your new field mapping:

  1. Navigate into the Integrations screen
  2. Click green “New field mapping” button
  3. Label the field mapping and optionally add a description
  4. From the Integration type menu, select “RD Station”
  5. Save

3. Add Email Address as Outbound field

The email address must be added as an outbound field to retrieve data from RD Station. 

  1. Click green “New outbound field” button
  2. Select Data field from the Source drop-down
  3. Select the data field category then data collection field you’ll use as the key
    • For email, select Contact Info > Email Address
  4. Make your field required to run the integration
  5. Select the corresponding RD Station field
  6. Save

4. Create Inbound fields

Inbound fields will map the data RD Station returns into their corresponding Ion data collection fields.

  1. Click green “New inbound field” button
  2. From the Target dropdown menus, selection the Ion data collection field you seek to populate with RD Station data
    • To pre-populate ion forms with RD Station data, be sure to select the data collection field used on your form
  3. From the Source dropdown, select the RD Station field you want to pull data from
    • OR, select Javascript code if you want to transform the RD Station data prior to storing it in Ion data collection
  4. Save
  5. Repeat these steps for each RD Station data field you seek to save into Ion data collection

5. Create integration

  1. Navigate back to Integrations screen
  2. Click into the Integrations tab
  3. Click green “New integration” button
  4. Enter label
  5. Optionally add a description
  6. Select the Field Mapping you’ve just created
  7. Skip Maximum retries
  8. Select Get Lead as the API method
  9. Click the key dropdown and select email
    • This is the field RD Station will use as the key to retrieve data
  10. Optionally add yourself to the debug distribution list for testing
    • This will deliver an email to the designated address when the integration runs that displays the request and response from RD Station
    • Check “Only send error emails” if you want to receive the debug email only when there is an error

6. Add integration to Ion pages

The Ion platform runs the integration based on rules you create. For RD Station Get Lead, the rule will typically run the integration at the page-level of the landing page. You can, however, run the integration on any actionable step in your Ion experience. The steps below walk through adding the rule at the page-level to populate an Ion form with RD Station data.

  1. Navigate into the testing creative with form that you set up prior to beginning the integration steps
  2. Under the Page tab in creative studio, click on +RULES
  3. Add the following rule:
    • Condition: No conditions required
    • Action: Run integration (select RD Station, Get Lead integration)
  4. Save

7. Test integration

To test your integration, use the creative you’ve added the page-level rule to in the previous step. Please note, integrations do not run in Preview Mode, so you’ll want to open a URL for testing.

When running the RD Station Get Let integration at the page level, an email address has to be passed in on the query string. To test, append ?EmailAddress= to the URL and set it equal to an email address that exists within your RD Station account.

NOTE: EmailAddress is a standard field name for the Ion email address field, but please be sure that the parameter name you append to the URL matches the “data name” of the Ion data collection field you are using (if something other than EmailAddress).

The integration will run when you visit the page. Ion form fields included in the field mapping will pre-populate with data retrieved from RD Station, if available.

If you’re on the debug email distribution list, you’ll receive an email that displays the request and response from RD Station.

Nice work!

Once you’ve completed these steps, your integration is ready for use. You can add the rule to run the integration on all applicable creatives.

As noted, RD Station Get Lead can be used to accomplish other objectives. Here are some examples that can be accomplished using this integration and ion’s Rules engine:

  • Shorten or replace forms
  • Auto-segment respondents
  • Build progressive profiles
  • Serve-up dynamic content based on RD Station data

If you have any questions, please contact us at [email protected].

Share this:

Charmaine Yu is a UX/UI designer at Rock Content. With over a decade of experience in visual arts, Charmaine combines her eye for design with her love of UX to create memorable interactive content at Rock. With a UX design diploma from Brainstation, she spent the last couple of years learning and creating new content in the world of UX. Outside of work, you can find her cuddling her dog, at the next music festival or coach-potating at home.