Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
customer_id
string
required

The customer unique identifier in your system

brand_id
string
required

The id of the brand that originate the event

type
string
required

The type of the event

Example:

"PURCHASE"

platform
string | null

Platform name where the event originated

order
object

The order in case of a PURCHASE event

product
object

The product in case of an ADD_TO_CART event

fulfilled
boolean
default:true

If the event was fulfilled, when false, rewards to be redeemed will be reserved until fulfilled

reserve
number<int2>
default:1

The number of days to reserve the rewards

redeem
object[]

The rewards to redeem in the order

tags
object

Include your conditions event tags here

referral_code
string

(Optional) The referral code to track the event

metadata
object

Include any additional info here

attribution
object

Optional campaign and matching context captured by the caller and forwarded with the event. Include the same context on the purchase. Cookies must be captured from the client; they are not generated from UTM values.

ga4
object

Google tag/Firebase identity and session captured when the event occurred. Optional: missing identity keeps the legacy customer-ID fallback on the web stream, without reliable session attribution. Never include API secrets.

issued_at
string<date-time>

Optional ISO 8601 timestamp of when the event occurred. It must include timezone information: use UTC with Z (recommended) or an explicit offset such as -05:00. Do not append Z to an unconverted local time. Must be within the last 72 hours and cannot be in the future. Defaults to the current server time if not provided.

Example:

"2026-03-25T10:00:00.000Z"

Response

Event enqueued for processing

data
object