Artisan IMG > Listrak (listrak) (84d70dc7-0c32-4f02-be78-779e29c34ad8)

Listrak
1.1

Listrak is a digital marketing automation platform trusted by 1,000+ leading brands for email marketing, mobile messaging, customer insights and cross-channel orchestration.

Overview
Copy

The Listrak API allows you to integrate with Listrak's application. The Listrak platform boasts a comprehensive set of marketing automation and CRM solutions that unify, interpret and personalize data to engage customers across channels and devices. It enables the seamless automation of a broad set of functionality, ranging from basic tasks to complex processes.

Authentication
Copy

When using the Listrak connector, the first thing you will need to do is go to your Tray.io account page, and select the relevant workflow. Once in the workflow dashboard itself, search and drag the Listrak connector from the connectors panel (on the left hand side) onto your workflow.

With the new Listrak connector step highlighted, in the properties panel on the right, click on 'New Authentication' which is located under the 'Settings' heading.

In order to create a new authentication two keys are required. A 'Client ID' and a 'Client secret'.

IMPORTANT!: Please note that in order to enable API access, you MUST create an Integrationon the Integrations page. Instructions on how to create and obtain your 'Client ID' and a 'Clientsecret' can be found HERE at the Listek Integration-Setupsection.

When you have followed the above link's instructions, you should have all the requirements you need for your Tray.io authentication box.

Once you have named your authentication appropriately, and added your 'Client ID' and a 'Client secret'; simply click the 'Add authentication' button to finish the process.

Your auth field will now automatically select the Listrak auth created until stipulated otherwise.

Available Operations
Copy

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Example Usage
Copy

This short example will demonstrate the use of the 'Create Segmentation field' operation in order to create a list in your Listrak account, to "list all the lists" within your account.

FYI: A Segmentation Field is used to store data about a contact so that it can be filtered in the future.

TRAY POTENTIAL: Tray.io is extremely flexible. By design there is no fixed way of working with it - you can pull whatever data you need from other services and work with it using our core and helper connectors. This demo which follows shows only one possible way of working with Tray.io and the Listrak connector. Once you've finished working through this example please see our Introduction to working with data and jsonpaths page and Data Guide for more details.

The steps will be as follows:

  1. Setup your manual trigger and list all the available lists within the account.

  2. Create the Segmentation field in the chosen list.

The completed workflow looks like this:

1 - Setup & listing
Copy

The first step is to go to your Tray.io dashboard, click on the 'Create new workflow' button in the top right corner and name your project workflow. This can be edited later if need be.

Search and select the 'Manual trigger'. There is only one operation available for this trigger and no authorisation needed.

Once within your workflow dashboard, go to the connectors panel on the left and search and select the Listrak connector. Add this to the second step of your workflow (making sure to double check that your authentication is automatically set).

Set the operation to 'List lists' from the dropdown available.

2 - Create a segmentation field
Copy

The 'Create a segmentation field' operation lets you create a new segmentation field for the specified segmentation field group in question.

You can select the "List ID" from the previous 'List lists' operation using the JSON path: $.steps.listrak-1.data[0].listId and the connector-snake.

JSONPATHS: For more information on what jsonpaths are and how to use jsonpaths with Tray, please see our pages on Basic data concepts and Mapping data between steps

CONNECTOR-SNAKE: The simplest and easiest way to generate your jsonpaths is to use our feature called the Connector-snake. Please see the main page for more details.

Once a List ID is selected, you will be need to further select a 'Segmentation field group ID'. This is the ID that is associated to the specific list, from the drop down options in the Segmentation field group IDs input field.

Fill the remaining input fields as required, and run the workflow to create a Segmentation field.

Please be aware that if a List does not have Segmentation field groups, the drop down will be empty