purchase.created

Published when a contact successfully completes a purchase via a referral link.

Event type: in.org.quicko.cliq.purchase.created

Event Schema

Field	Type	Description
id	string (uuid)	Unique event ID
time	string (ISO 8601)	Time the event occurred
specversion	string	CloudEvents spec version
datacontenttype	string	application/json
program_id	string (uuid)	Program the purchase belongs to
promoter_id	string (uuid)	Promoter who owns the referral link
source	string	Originating endpoint
type	string	Event type identifier
data	object	Event data (see below)
subject	string (uuid)	Purchase ID

data

Field	Type	Description
@entity	string	in.org.quicko.cliq.purchase
trigger_type	string	purchase
purchase_id	string (uuid)	ID of the purchase
contact_id	string (uuid)	ID of the contact who made the purchase
promoter_id	string (uuid)	Promoter who owns the referral link
link_id	string (uuid)	Referral link used for the purchase
item_id	string	Identifier of the purchased item
amount	number	Purchase amount
created_at	string (ISO 8601)	Purchase creation timestamp
updated_at	string (ISO 8601)	Purchase last updated timestamp
utm_params	object	UTM tracking parameters (optional)

utm_params

Field	Type	Description
utm_id	string	UTM ID
utm_source	string	UTM source (e.g. instagram)
utm_medium	string	UTM medium (e.g. social)
utm_campaign	string	UTM campaign name
utm_term	string	UTM term
utm_content	string	UTM content

Example Payload

{
  "id": "fbae5207-0cc7-4a42-8dd3-b58aa6a44f8c",
  "time": "2026-04-06T06:23:54.991Z",
  "specversion": "1.0",
  "datacontenttype": "application/json",
  "program_id": "930433e7-591c-4dda-a300-d3bfe17bd03d",
  "promoter_id": "c06d4f0f-ccfb-4d6e-8bed-eea28460b698",
  "source": "urn:POST:/purchases",
  "type": "in.org.quicko.cliq.purchase.created",
  "data": {
    "@entity": "in.org.quicko.cliq.purchase",
    "trigger_type": "purchase",
    "purchase_id": "9aafd54c-03f5-40c0-8dba-df50e974e731",
    "contact_id": "6a3e05ae-a0c1-4d09-9d8c-112929601246",
    "promoter_id": "c06d4f0f-ccfb-4d6e-8bed-eea28460b698",
    "link_id": "92f75eee-ecc8-47c4-87d9-dea983114fef",
    "item_id": "item1",
    "amount": 420,
    "created_at": "2026-04-06T06:23:54.793Z",
    "updated_at": "2026-04-06T06:23:54.793Z",
    "utm_params": {
      "utm_id": "email_apr_newsletter",
      "utm_source": "newsletter",
      "utm_medium": "email",
      "utm_campaign": "product_update_april",
      "utm_term": "existing_users",
      "utm_content": "cta_button_top"
    }
  },
  "subject": "9aafd54c-03f5-40c0-8dba-df50e974e731"
}