Klaviyo

Authentication Type: API Key
Description: Track customer events and behaviors for email marketing and customer engagement.

Events

Track customer events and behaviors in Klaviyo.

Track Event

Track a customer event in Klaviyo for marketing automation. Requires at least email or phone in the profile.

Operation Type: Mutation (Write)

Parameters:

• event string (required): Name of the event to track (e.g. "Purchased Product", "Viewed Page")
• profile object (required): Customer profile information - at least one field must be non-empty
  • email string (nullable): Customer email address (leave empty if not available)
  • phone string (nullable): Customer phone number (leave empty if not available)
  • external_id string (nullable): External customer ID (leave empty if not available)
• properties array of objects (required): Additional event properties and metadata as key-value pairs
  • key string: Property name
  • value string: Property value
• time string (nullable): ISO 8601 timestamp of when the event occurred (leave empty to use current time)

Returns:

• eventId string: Unique identifier for the tracked event
• success boolean: Whether the event was successfully tracked

Example Usage:

{
  "event": "Purchased Product",
  "profile": {
    "email": "customer@example.com",
    "phone": "+1-555-123-4567",
    "external_id": "user_12345"
  },
  "properties": [
    {
      "key": "product_name",
      "value": "Premium Wireless Headphones"
    },
    {
      "key": "purchase_amount",
      "value": "299.99"
    },
    {
      "key": "currency",
      "value": "USD"
    },
    {
      "key": "category",
      "value": "Electronics"
    },
    {
      "key": "brand",
      "value": "AudioTech"
    }
  ],
  "time": "2024-01-15T14:30:00Z"
}

Common Use Cases

E-commerce Marketing Automation:

• Track purchase events with product details, amounts, and customer information for targeted follow-up campaigns
• Monitor cart abandonment and checkout behaviors to trigger recovery email sequences
• Record product views and browsing patterns to personalize product recommendations and marketing content

Customer Engagement Tracking:

• Track website interactions like page views, content downloads, and form submissions for lead scoring
• Monitor customer support interactions and satisfaction surveys to trigger appropriate follow-up communications
• Record subscription and preference changes to maintain accurate customer profiles for segmentation

Event-Driven Campaigns:

• Trigger welcome email series when customers complete registration or first purchase events
• Send personalized offers based on specific product categories or purchase amounts from tracked events
• Create behavioral segments using event properties like purchase frequency, average order value, and product preferences

Customer Journey Analytics:

• Track multi-touchpoint customer journeys from initial website visit through purchase completion
• Monitor customer lifecycle events like birthdays, anniversaries, and subscription renewals for targeted campaigns
• Analyze customer behavior patterns using event properties to optimize marketing timing and messaging