Skip to main content
Subtotal delivers the following custom events to Braze via the users.track endpoint. Each event can be used to trigger campaigns, build segments, or power Canvas journeys.

Purchased at Retailer

Triggered when a purchase is shared with your brand. Sent for qualifying historical purchases and newly shared purchases. This is the Braze event for the Purchase shared trigger. status is the purchase status when the event is sent. A later status change sends no event; read it from GET /purchases/. Example

Connected an Account

Triggered when a consumer links a retail account. Example

Disconnected an Account

Sent when the consumer, or your app through the API, disconnects the connection. Example

Unauthenticated Connection

Triggered when an active connection becomes unauthenticated and requires the customer to reauthenticate (e.g. after a retailer password change). Example

Reauthenticated Connection

Sent each time a connection signs in after it has lost access at least once, including routine sign ins. Subtotal also sends Purchased at Retailer for purchases collected since the connection last lost access. Example

Profile Created

Triggered the first time Subtotal captures a consumer’s profile for a connection — their identity details and purchase metrics scoped to your brands. Use it to enrich Braze user profiles with first-party retail identity. Example

Profile Updated

Sent when the collected identity changes: name, email, mobile, postal code or retailer account creation date. New purchases alone do not send it. Each profile event carries the latest purchase metrics and the same properties as Profile Created. Example