# Klaviyo

> Track customer events and behaviors for email marketing and customer engagement.

Source: https://cotera.co/docs/reference/tools/individual-tools/klaviyo

---

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

***

## Authentication

To authenticate, you'll need a Klaviyo API key. Learn how to create one in the [Klaviyo Help Center](https://help.klaviyo.com/hc/en-us/articles/115005062267).

***

## 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:**

```json
{
  "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