Listrak Data Push

Overview

Oracle CrowdTwist integrates with Listrak to using real-time API calls. This allows a client’s loyalty profile data to flow into their Listrak instance in real-time and be made available for communications.

This is achieved by Oracle CrowdTwist structuring their push feeds to match the API format of Listrak, allowing Oracle CrowdTwist to populate the mutual client’s Listrak instance. Authorization is handled via Client ID and Client Secret, generated with by the client from within their Listrak instance.

NOTE: This requires the client to have their own Listrak instance. Additional details on the integration can be found here (external site).

Data Push Feeds

The following types of data feeds can be enabled:

  • User Profile: Includes creations of new profiles and updates to existing profiles

Integration Setup Process

  1. Client enables the CrowdTwist integration from within the Listrak Integration Manager
  2. Client provides the configuration details to Oracle CrowdTwist
    • Integration Client ID
    • Integration Client Secret

API Endpoint for Authorization

  • https://auth.listrak.com/OAuth2/Token

API Endpoint for Data Population

  • https://api.listrak.com/data/v1/Customer

NOTE: Pushes to Listrak are throttled to 1 call/minute with each call containing data for up to 1,000 members.

Data Formats

NOTE: The specified member’s email address must already exist in the Listrak Loyalty List. This should be populated via the registration flow.

Field Name

Data Type

CrowdTwist Mapped Field

Sample Data

address1

String

streetAddress1

100 Mockingbird Lane

address2

String

streetAddress2

Floor 8

City

String

city

New York

Country

String

country

US

State

String

state

NY

Birthday

Date

dateOfBirth

1991-11-12T08:00:00Z

customerNumber

String

thirdPartyID

123456789

email

String

emailAddress

test@test.com

firstName

String

firstName

Jane

lastName

String

lastName

Doe

gender

String

gender

- Male
- Female
- Other
- Non-Binary
- Prefer not to identify

activeLoyaltyMember

Boolean

isActive

1

availablePoints

Number

redeemablePoints

60

curentTierLevel

String

tierInfo.curentLevel.title

Tier 1

enrollDate

Date

dateCreated

2020-02-15T07:24:57Z

lastActivityDate

Date

dateLastUpdated

2020-09-27T07:30:12Z

lastPointEarnedDate

Date

tierInfo.dateReached

2020-02-15T07:24:57Z

lifetimePoints

String

totalPoints

200

loyaltySignUpSource

String

signUpChannelID, signUpCampaign

1,BonusWeek

monthlyPoints

String

monthlyPoints

100

nextTierLevel

String

tierInfo.nextLevel.title

Tier 2

pointExpirationDate

String

tierInfo.expirationDate

2020-12-31T23:59:59Z

pointsToNext

String

tierInfo.scoreNeededToReach

150

rewardsID

String

CTID

987654321

weeklyPoints

String

weeklyPoints

50

mobilePhone

String

mobilePhoneNumber

12121112222

facebookId

String

facebookUserID

username

facebookNumberOfFriends

String

numFacebookFriends

0

instagramID

String

instUserUD

null

twitterID

String

twitterUserID

null

twitterNumberOfFollowers

String

numTwitterFollowers

0

zipCode

String

postalCode

10010