Connectors / Service / Listrak

Artisan IMG > Listrak (listrak)

Listrak

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

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

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.

add-auth

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.

Listrak auth

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

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

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:

Completed Listrak workflow

1 - Setup & listing

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.

listrak-manual-trigger

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.

List lists

2 - Create a segmentation field

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.io, please see our Intro page and Data Guide for more details.

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

Select list ID

All Operations

Latest version:

1.1

List segmentation fields DDL

List contacts DDL

Create a list

Creates a new list in your account.

Create or update contact

Creates or updates a contact on the specified list.

Create segmentation field

Creates a new segmentation field for the specified segmentation field group.

Create segmentation field group

Creates a new segmentation field group for the specified list.

Get campaign

Returns the specified campaign on the specified list.

Get contact

Retrieves information about a contact.

Get list

Returns the specified list.

List IP pools

Returns your account's collection of IP pools.

List campaigns

Returns the campaigns associated with the specified list.

List campaigns DDL

List contacts

Returns the collection of contacts associated with the specified list.

List event groups

Returns the collection of event groups associated with the specified list.

List events

Returns the collection of events associated with the specified list.

List events DDL

List ip pools DDL

List lists

Returns your account's collection of lists.

List lists DDL

List segmentation field groups

Returns a collection of segmentation field groups for the specified list.

List segmentation field groups DDL

List segmentation fields

Returns the collection of segmentation fields that exist for the specified segmentation field group.

Raw HTTP request (advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.