Skip to main content

​
Overview

Our integration with Attentive makes it easy to reward customers for linking accounts and making retail purchases. We’ll show you how to make the most out of this integration.

​
Connect your Attentive account

Sign in to the Subtotal Dashboard and connect your Attentive account to enable the integration. Navigate to Integrations -> Attentive -> Connect. Click the Connect Attentive button. subtotal attentive integration

​
Configuration

SettingDescription
Customer IdentifierThe field on the connection to use when identifying the customer in the Attentive platform: Email, Customer ID, or Mobile.

​
Event types

Subtotal delivers the following custom events to Attentive. Each event can be used to trigger journeys or build segments.

​
Connected an Account

Sent when a customer connects a retailer account.
KeyTypeDescription
connection_idstringIdentifier for the connection
Example 
{
  "connection_id": "01KFRSK9J11G807TAY0GCYSW67"
}

​
Purchased at Retailer

Sent for each historical purchase and for any newly detected purchases.
KeyTypeDescription
purchase_idstringIdentifier for the purchase
Example 
{
  "purchase_id": "01KEVN1ZPM9H19JSHGN5NF0M69"
}

​
Profile Created

Sent the first time Subtotal captures a customer’s profile for a connection — their identity details and purchase metrics scoped to your brands.
KeyTypeDescription
connection_idstringIdentifier for the connection
first_namestringCustomer’s first name (null if unavailable)
last_namestringCustomer’s last name (null if unavailable)
emailstringCustomer’s email address (null if unavailable)
mobilestringCustomer’s mobile phone number (null if unavailable)
postal_codestringCustomer’s postal code (null if unavailable)
account_created_datestringWhen the customer’s retailer account was created (ISO 8601; null if unknown)
total_purchasesnumberAll-time number of purchases on the connected account
last_purchase_datestringDate of the most recent purchase (ISO 8601; null if none)
brand_purchasesnumberNumber of those purchases matching your brands
last_brand_purchase_datestringDate of the most recent brand purchase (ISO 8601; null if none)
brand_purchase_ratenumberbrand_purchases ÷ total_purchases, from 0.0 to 1.0
Example 
{
  "connection_id": "01KFRSK9J11G807TAY0GCYSW67",
  "first_name": "Jessica",
  "last_name": "Smith",
  "email": "jessica@acme.com",
  "mobile": "+123456789",
  "postal_code": "84101",
  "account_created_date": "2024-03-12T00:00:00Z",
  "total_purchases": 42,
  "last_purchase_date": "2026-01-15T14:30:00Z",
  "brand_purchases": 7,
  "last_brand_purchase_date": "2026-01-14T09:45:00Z",
  "brand_purchase_rate": 0.17
}

​
Profile Updated

Sent when a previously captured profile changes — for example an updated email or postal code, or when new purchases shift the brand-purchase metrics. Carries the same properties as Profile Created.
KeyTypeDescription
connection_idstringIdentifier for the connection
first_namestringCustomer’s first name (null if unavailable)
last_namestringCustomer’s last name (null if unavailable)
emailstringCustomer’s email address (null if unavailable)
mobilestringCustomer’s mobile phone number (null if unavailable)
postal_codestringCustomer’s postal code (null if unavailable)
account_created_datestringWhen the customer’s retailer account was created (ISO 8601; null if unknown)
total_purchasesnumberAll-time number of purchases on the connected account
last_purchase_datestringDate of the most recent purchase (ISO 8601; null if none)
brand_purchasesnumberNumber of those purchases matching your brands
last_brand_purchase_datestringDate of the most recent brand purchase (ISO 8601; null if none)
brand_purchase_ratenumberbrand_purchases ÷ total_purchases, from 0.0 to 1.0
Example 
{
  "connection_id": "01KFRSK9J11G807TAY0GCYSW67",
  "first_name": "Jessica",
  "last_name": "Smith",
  "email": "jessica.smith@acme.com",
  "mobile": "+123456789",
  "postal_code": "84101",
  "account_created_date": "2024-03-12T00:00:00Z",
  "total_purchases": 43,
  "last_purchase_date": "2026-02-02T18:05:00Z",
  "brand_purchases": 8,
  "last_brand_purchase_date": "2026-02-02T18:05:00Z",
  "brand_purchase_rate": 0.19
}