Skip to main content
Use these as starter payloads and adjust identifiers, timestamps, and metadata for your product.

​
Base Shape

{
  "email": "buyer@example.com",
  "type": "purchase",
  "source": "api",
  "action": "renewed",
  "feature": "billing",
  "plan": "pro",
  "amount": 49.9,
  "idempotency_key": "purchase-buyer-example-com-20260622"
}

​
Minimum payload

{
  "email": "buyer@example.com",
  "type": "purchase"
}

​
1) Signup

{
  "email": "newuser@example.com",
  "type": "signup",
  "source": "organic",
  "idempotency_key": "signup-newuser-example-com-20260622"
}

​
Minimum payload

{
  "email": "newuser@example.com",
  "type": "signup"
}

​
2) Purchase Success

{
  "email": "buyer@example.com",
  "type": "purchase",
  "status": "success",
  "plan": "pro",
  "amount": 49.9,
  "upgrade": false,
  "idempotency_key": "purchase-buyer-example-com-20260622-1"
}

​
Minimum payload

{
  "email": "buyer@example.com",
  "type": "purchase",
  "status": "success"
}

​
3) Trial Started

{
  "email": "trialuser@example.com",
  "type": "purchase",
  "status": "trial_started",
  "plan": "trial",
  "idempotency_key": "trial-trialuser-example-com-20260622"
}

​
Minimum payload

{
  "email": "trialuser@example.com",
  "type": "purchase",
  "status": "trial_started"
}

​
4) Core Activity (Login)

{
  "uid": "usr_00123",
  "type": "core_activity",
  "action": "login",
  "source": "web_app",
  "idempotency_key": "login-usr-00123-20260622t110001z"
}

​
Minimum payload

{
  "uid": "usr_00123",
  "type": "core_activity",
  "action": "login"
}

​
5) Feature Exploration

{
  "uid": "usr_00123",
  "type": "feature_used",
  "action": "explored",
  "feature": "automation_builder",
  "source": "dashboard",
  "idempotency_key": "feature-explored-usr-00123-20260622"
}

​
Minimum payload

{
  "uid": "usr_00123",
  "type": "feature_used",
  "action": "explored"
}

​
6) Support Escalation Pattern

{
  "email": "help@example.com",
  "type": "support_ticket",
  "action": "multiple_tickets",
  "source": "support_system",
  "idempotency_key": "support-multiple-help-example-com-20260622"
}

​
Minimum payload

{
  "email": "help@example.com",
  "type": "support_ticket",
  "action": "multiple_tickets"
}

​
7) Cart Abandoned

{
  "email": "shopper@example.com",
  "type": "cart",
  "status": "abandoned",
  "action": "abandoned",
  "amount": 129.0,
  "idempotency_key": "cart-abandoned-shopper-example-com-20260622"
}

​
Minimum payload

{
  "email": "shopper@example.com",
  "type": "cart",
  "status": "abandoned"
}

​
8) Re-Engagement Return

{
  "email": "returning@example.com",
  "type": "re_engagement",
  "action": "returned",
  "status": "success",
  "idempotency_key": "reengaged-returning-example-com-20260622"
}

​
Minimum payload

{
  "email": "returning@example.com",
  "type": "re_engagement",
  "action": "returned"
}

​
Bulk Submission Example

{
  "events": [
    {
      "email": "newuser@example.com",
      "type": "signup",
      "source": "organic",
      "idempotency_key": "signup-newuser-example-com-20260622"
    },
    {
      "email": "buyer@example.com",
      "type": "purchase",
      "status": "success",
      "plan": "pro",
      "amount": 49.9,
      "idempotency_key": "purchase-buyer-example-com-20260622-1"
    }
  ]
}

​
Minimum payload

{
  "events": [
    {
      "email": "newuser@example.com",
      "type": "signup"
    },
    {
      "email": "buyer@example.com",
      "type": "purchase"
    }
  ]
}

​
Invalid Example And Fix

Invalid (missing email and uid): 
{
  "type": "signup"
}
Fixed: 
{
  "email": "fixed@example.com",
  "type": "signup",
  "idempotency_key": "signup-fixed-example-com-20260622"
}

​
Example Quality Checklist

  • include deterministic idempotency_key values
  • use canonical event type names
  • include source for easier diagnostics
  • include ts when importing historical events
  • keep metadata compact and meaningful