SubscriptionStarted Event Example

Events sent via Backend API typically involve sensitive data or require server-side validation and processing. Let's see the SubscriptionStarted event as an example:

{
  "eventTypeKey": "SubscriptionStarted",
  "params": {
    "externalCustomerId": "a7c9f9b8-d3a2-401c-8b93-7f3d4f91bfa2",
    "subscriptionPlan": "Premium",
    "startDate": "2024-01-01T12:00:00Z",
    "price": 49.99,
    "currency": "USD",
    "billingCycle": "Monthly"
  }
}

Explanation of Fields

  1. eventTypeKey: "SubscriptionStarted"
    • Indicates the type of event being generated.
  2. params: An array of objects with name and value pairs.
    • externalCustomerId: Unique customer identifier.
    • subscriptionPlan: The plan the customer has subscribed to (e.g., Basic, Premium).
    • startDate: ISO 8601 date-time format specifying when the subscription began.
    • price: Cost of the subscription plan.
    • currency: Currency of the subscription cost.
    • billingCycle: Frequency of billing (e.g., Monthly, Yearly).

This request can be sent via the Generate Event API to track user subscription activities, trigger workflows, and personalize messages based on event data.