Klaviyo MCP Server
for AI Agents

Retrieve all Klaviyo accounts associated with the current API key. Always returns exactly one account object per key.

Retrieve detailed configuration for a specific Klaviyo account by its unique account ID.

Create a new email, SMS, or mobile push campaign as a draft. Requires specifying the channel, audiences, and at least one campaign message.

Duplicate an existing campaign to create a new Draft campaign, optionally giving it a new name.

Trigger a campaign to send immediately (or at its configured scheduled time) by creating an asynchronous send job. Campaign message must have a template assigned (via assign_template_to_campaign_message) and an audience configured before sending.

List email, SMS, or push campaigns with required channel filter and optional sorting and pagination.

Retrieve complete details for a single campaign by its unique ID, including status, audiences, send strategy, and tracking options.

Update campaign properties such as name, target audiences, send strategy, or tracking options before the campaign is sent.

Permanently delete a campaign by ID. This action cannot be undone. Only Draft campaigns can be deleted.

Retrieve full details for a specific campaign message by its unique ID, including channel-specific content and render options.

Update the content and settings of a campaign message, including channel-specific fields such as subject, body, sender info, and mobile push options.

Create a new product catalog item with title, description, URL, price, and images, optionally assigning it to one or more catalog categories.

List all product catalog items in the account with filtering by title, category, or IDs, sorting by creation date, and cursor-based pagination up to 100 items per page.

Retrieve the full details of a specific catalog item by its compound ID, with optional variant inclusion and sparse fieldsets.

Update an existing catalog item's title, description, URL, price, images, or published status using PATCH semantics - only supplied fields are changed.

Permanently delete a catalog item by its compound ID, removing it from all recommendation feeds and product blocks.

Create a new product catalog category with an external ID and display name, optionally assigning catalog items to it at creation time.

Retrieve the full details of a specific catalog category by its compound ID, including its name and external ID.

Update an existing catalog category's name or item associations using PATCH semantics - only supplied fields are changed.

Permanently delete a catalog category by its compound ID, removing the category grouping without deleting the items it contained.

Create a new catalog variant (size, color, or style variation) for an existing catalog item, with SKU, inventory, price, and URL.

List all product catalog variants in the account with filtering by item, SKU, title, or published status, sorting by creation date, and cursor-based pagination up to 100 variants per page.

Retrieve the full details of a specific catalog variant by its compound ID, including SKU, inventory quantity, price, and published status.

Update an existing catalog variant's SKU, price, inventory quantity, title, images, or published status using PATCH semantics - only supplied fields are changed.

Permanently delete a catalog variant by its compound ID, removing it from recommendation feeds and back-in-stock subscription eligibility.

Create a new coupon container with a unique external ID, matching your e-commerce platform's coupon identifier.

List all coupons in the account with optional sparse fieldsets and cursor-based pagination.

Retrieve complete details for a specific coupon by its unique Klaviyo coupon ID.

Update the description or monitor configuration of an existing coupon. The external_id cannot be changed after creation. Note: Shopify-originated coupons (synced from Shopify via Klaviyo UI) return 404 on get/update/delete — they are not accessible via the Coupons API.

Permanently delete a coupon and all its associated coupon codes. This action is irreversible. Note: Shopify-originated coupons (synced from Shopify via Klaviyo UI) return 404 on get/update/delete — they are not accessible via the Coupons API. Only API-created or non-Shopify UI-uploaded coupons can be managed.

Create a single unique coupon code and associate it with an existing coupon. Use bulk_create_coupon_codes for creating multiple codes at once.

List coupon codes filtered by coupon ID or profile ID. A filter specifying coupon.id or profile.id is required.

Retrieve full details for a specific coupon code by its unique ID, including its status, unique code value, and expiration date.

Update the status or expiration date of an existing coupon code. Useful for manually marking codes as used or extending their validity.

Permanently delete a single coupon code by its ID. This action is irreversible.

Track a server-side customer activity event for a profile, such as a purchase, page view, or custom business action.

List Klaviyo events (customer activity records) with optional filtering by metric, profile, or date range.

Retrieve complete details for a specific event by its unique ID, including all event properties and optional metric and profile data.

Create a new Klaviyo automation flow with a trigger, chained actions, and optional profile filters. Use this to programmatically set up welcome series, abandoned cart, post-purchase, birthday, and other automated messaging workflows.

List all Klaviyo automation flows with optional filtering by name, status, trigger type, and date, plus pagination and sorting.

Retrieve the full configuration of a specific Klaviyo flow by its unique ID, including trigger definition and optional flow actions.

Permanently delete a flow and all its actions by flow ID. Use this to remove test flows or decommission automation workflows. This action cannot be undone.

Retrieve detailed configuration for a single flow action step by its unique ID, including its type, branching links, and optional message content.

Update a single action within a flow — change email subject lines, SMS body text, delay durations, split conditions, or action status. Use this to modify existing flow actions without recreating the entire flow.

Create a new Klaviyo form — popup, flyout, embed, banner, or full screen. Use this to programmatically deploy signup forms, coupon popups, back-in-stock alerts, and other customer-facing form experiences.

List all signup forms and pop-ups in the account with filtering, sorting, and cursor-based pagination up to 100 results per page.

Retrieve the full configuration and version history for a specific Klaviyo form by its unique ID.

Permanently delete a form by its ID. Use this to remove test forms or decommission form experiences. This action cannot be undone.

List all images in the Klaviyo asset library with filtering by name, format, size, or visibility, plus sorting and pagination.

Retrieve complete metadata for a specific image in the Klaviyo asset library by its unique ID.

Update the name or visibility (hidden status) of an existing image in the Klaviyo asset library.

List all event metric types tracked in the Klaviyo account, including built-in and integration-specific metrics, up to 200 per page.

Retrieve complete details for a specific event metric type by its unique ID, including integration source and optional flow trigger relationships.

Create a new custom composite metric that aggregates multiple base metrics into a single unified metric for attribution and reporting.

List all custom composite metrics in the account that combine multiple underlying metrics into a single unified reporting and attribution metric.

Retrieve the full definition and composition details for a specific custom composite metric by its unique ID.

Update the name or definition of an existing custom composite metric using PATCH semantics.

Permanently delete a custom composite metric from the account by its unique ID.

Create a new customer profile with contact details, location, and custom properties; at least one of email, phone_number, or external_id must be provided to uniquely identify the profile.

List all customer profiles in the account with rich filtering, sorting, subscription and predictive analytics data, up to 100 per page.

Retrieve the complete data for a specific customer profile by its Klaviyo ID, including optional subscription consent, list/segment memberships, and predictive analytics.

Update an existing customer profile's contact details, location, or custom properties using PATCH semantics, with support for appending to or unsetting specific custom property keys.

Create a new segment with complex condition groups

List all segments in the account with filtering by name, status, or timestamps, sorting, and cursor-based pagination, including optional tags and flow trigger inclusions.

Retrieve the full details of a specific segment by its unique ID, including its condition definition, active status, and optional tags and flow trigger inclusions.

Update an existing segment with new properties or definition

Permanently delete a segment from the account by its unique ID - this removes the segment definition but does not delete the profiles that were in it.

Create a new tag, optionally associating it with a specific tag group, or it defaults to the account's default tag group.

List all tags in the account with cursor-based pagination, name filtering, and optional tag group inclusion, up to 50 results per page.

Retrieve complete details for a specific tag by its unique ID, including optional tag group relationship.

Update the name of an existing tag by its unique ID using PATCH semantics.

Permanently delete a tag and automatically remove all its associations with campaigns, flows, lists, and segments.

Create a new tag group to organize related tags under a shared category, with optional exclusivity enforcement across the account.

List all tag groups in the account with filtering by name, exclusivity, or default status, and cursor-based pagination up to 25 results per page.

Retrieve the full details of a specific tag group by its unique ID, including its name, exclusivity setting, and default status.

Update the name of an existing tag group using PATCH semantics - only the name can be changed, not the exclusivity or default status.

Permanently delete a tag group and all of its tags and their resource associations - the account's default tag group cannot be deleted.

Create a new email template with custom HTML content or a drag-and-drop structure, for use in campaigns and automated flows.

Create a duplicate copy of an existing email template with an optional new name, useful for creating variations without modifying the original.

List all email templates in the account with filtering by name or timestamps, sorting, and cursor-based pagination up to 10 results per page.

Retrieve the full HTML content and metadata for a specific email template by its unique ID.

Update the HTML content, plaintext version, AMP version, or name of an existing email template using PATCH semantics - note that drag-and-drop (USER_DRAGGABLE) templates cannot be updated via API.

Permanently delete an email template from the account by its unique ID - this action cannot be undone.

Create a new reusable universal content block (button, image, text, HTML, spacer, horizontal rule, or drop shadow) that can be embedded across multiple email templates.

List all reusable universal content blocks in the account with filtering by name, content type, or timestamps, sorting, and pagination up to 100 per page.

Retrieve the full definition and metadata of a specific universal content block by its unique ID, including block type, content, display options, and styles.

Update the name or block definition of an existing universal content block using PATCH semantics - changes propagate to all templates that embed this block.

Permanently delete a universal content block from the account - any templates that embed this block will lose the reference and may display broken content.

Create a new webhook subscription with an HTTPS endpoint URL, signing secret, and one or more event topic subscriptions for real-time event notifications.

List all webhook subscriptions configured in the account, with optional inclusion of their subscribed topic definitions.

Retrieve the full configuration details of a specific webhook subscription by its unique ID, including endpoint URL, enabled status, and subscribed topics.

Update a webhook's name, endpoint URL, signing secret, enabled status, or topic subscriptions using PATCH semantics - useful for rotating secrets or changing event subscriptions.

Permanently delete a webhook subscription from the account, stopping all event notifications to that endpoint.

Retrieve all available webhook event topics that can be subscribed to, returning topic IDs and descriptions for use when creating or updating webhooks.

Retrieve the full details of a specific webhook topic by its ID, including the event schema, payload structure, and description for integration planning.