request_profile_deletion
Request Profile Deletion
Submit a data privacy deletion request for a profile in Klaviyo. Used for GDPR right-to-erasure and similar privacy compliance. The profile and all associated data will be permanently deleted.
request_profile_deletion
Submit a data privacy deletion request for a profile in Klaviyo. Used for GDPR right-to-erasure and similar privacy compliance. The profile and all associated data will be permanently deleted.
get_segments
Retrieve segments from Klaviyo. Segments are dynamic groups of profiles based on conditions such as behavior, engagement, location, or predictive analytics. Can fetch a single segment by ID or list all segments with optional filtering.
manage_subscriptions
Subscribe or unsubscribe profiles to/from email and SMS marketing for a specific list. Can also suppress or unsuppress profiles globally. Use this tool to manage consent and marketing opt-in/opt-out.
create_update_profile
Create a new customer profile or update an existing one in Klaviyo. When a profileId is provided, the existing profile will be updated. Otherwise a new profile is created. Supports setting email, phone, name, location, and custom properties.
track_event
Create a custom event in Klaviyo associated with a profile. Events can trigger flows, contribute to segments, and appear in analytics. Common use cases: tracking purchases, form submissions, quiz completions, password resets, and other custom actions.
query_metric_aggregates
Query aggregate analytics data for a specific metric in Klaviyo. Returns computed measurements like count, sum, or unique values over a time period. Useful for building reports on email opens, revenue, clicks, conversions, and other performance metrics.
update_flow_status
Change the status of an automation flow in Klaviyo. Flows can be set to draft, manual, or live status.
get_list_segment_profiles
Retrieve profiles belonging to a specific list or segment in Klaviyo. Supports filtering and pagination. Use this to see who is in a particular audience.
manage_coupons
Create and retrieve coupons in Klaviyo, and bulk-create coupon codes. Coupons are used in campaigns and flows to offer discounts.
manage_campaigns
Create, retrieve, update, delete, or send email/SMS/push campaigns in Klaviyo. Campaigns target lists and/or segments with marketing messages. Use this to manage the full campaign lifecycle.
get_events
Retrieve events (actions tracked for profiles) from Klaviyo. Filter by metric, profile, timestamp, or other attributes. Events include email opens, clicks, purchases, and any custom events.
get_profiles
Search and retrieve customer profiles from Klaviyo. Supports filtering by email, phone number, external ID, and custom properties using Klaviyo's filter syntax. Use pagination to iterate through large result sets.
get_metrics
Retrieve available metrics (event types) from Klaviyo. Metrics include built-in types like "Opened Email", "Placed Order", and any custom events. Use metrics to understand what event types are available for querying aggregates or filtering events.
manage_templates
Create, retrieve, update, delete, clone, or render email templates in Klaviyo. Templates are used in campaigns and flows for composing email content. Supports HTML and drag-and-drop editor types.
manage_catalog_items
Create, retrieve, update, or delete product catalog items in Klaviyo. Catalog items power product recommendations, back-in-stock notifications, price-drop flows, and dynamic template content. Also supports listing item variants and browsing categories.
manage_lists
Create, update, delete, or retrieve lists in Klaviyo. Also supports adding and removing profiles from lists. Lists are static collections of profiles used for campaign targeting.
manage_tags
Create, retrieve, update, or delete tags and tag groups in Klaviyo. Tags are used to organize campaigns, flows, lists, and segments for easier filtering and management.
get_flows
Retrieve automation flows from Klaviyo. Flows are automated messaging workflows triggered by events, list membership, or dates. Can fetch a specific flow by ID or list all flows. Optionally include flow actions.
query_reports
Query Klaviyo Reporting API values and time series for campaigns, flows, forms, and segments. Use this for performance reporting that is scoped to Klaviyo marketing assets rather than raw metric aggregates.
get_forms
Retrieve Klaviyo signup forms. Can fetch a single form by ID or list forms with filtering, sorting, sparse fields, and pagination. Use this to audit active forms, find form IDs, and verify list-building entry points.
get_account
Retrieve the Klaviyo account associated with the current credentials, including account identity, contact information, timezone, currency, and public API key when available. Use this to verify the connected account before making changes.
manage_images
List, retrieve, upload from URL or data URI, and update Klaviyo images used in templates and campaigns. Use upload to import a hosted image or data URI into Klaviyo's image library.
Manage email, SMS, and push notification marketing campaigns for eCommerce. Create and update customer profiles, manage lists and segments, build automated messaging flows, track events, and query performance reports. Supports product catalog management for recommendations and back-in-stock alerts, coupon creation, email template design, form management, and audience segmentation based on behavioral and predictive data. Subscribe and unsubscribe profiles from marketing channels, request data privacy deletions, and configure webhooks for real-time event forwarding.
Common questions about connecting Klaviyo to AI agents with Metorial.