How to integrate Klaviyo MCP with Kimi Code

Connect Kimi Code to Klaviyo MCP. Add new subscribers to main email list, clone last week's campaign for reuse, and more using natural language, with authentication handled for you.

Klaviyo logoKlaviyo
Api KeyOauth2

Klaviyo is a data-driven email and SMS marketing platform for e-commerce brands. It helps deliver targeted messages, track conversions, and build scalable customer relationships.

233 Tools

How to integrate Klaviyo MCP with Kimi Code

Kimi Code is Moonshot AI's open-source coding agent, powered by Kimi K2.6. It runs in your terminal, reads and edits code, executes shell commands, and plans multi-step tasks, with native MCP support for extending it to outside tools.

In this guide, I will explain the easiest and most secure way to connect your Klaviyo account to Kimi Code via Composio Connect, so it can add new subscribers to main email list, clone last week's campaign for reuse, estimate recipients for upcoming product launch, and more without ever putting your account credentials at risk.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Klaviyo with

Why use Composio?

Composio provides:

  • Access to 1,700+ managed apps from a single MCP endpoint. This makes it convenient for agents to run cross-app workflows.
  • Managed OAuth. You do not have to worry about authentication and authorization flows for every app.
  • Programmatic tool calling. Allows LLMs to write code in a remote workbench to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Large tool response handling outside the LLM context. This minimizes context bloat from large tool responses.
  • Dynamic just-in-time access to thousands of tools across hundreds of apps. Composio loads the tools your agent needs, so LLMs are not overwhelmed by tools they do not need.

Connect Klaviyo to Kimi Code

Kimi Code is a TypeScript agent distributed through npm. It acts as an MCP client and reads server definitions from an mcp.json file, and it can also add and authenticate servers conversationally through /mcp-config. Composio is a remote HTTP server that authenticates with OAuth, so no API key is stored anywhere.

1. Install Kimi Code

The quickest way is the official install script, which requires no pre-installed Node.js and places the kimi executable on your PATH.

bash
# macOS or Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# Confirm the installation
kimi --version

2. Log in

Start Kimi Code in your project directory, then sign in from the interactive UI:

bash
kimi

Run /login and choose Kimi Code OAuth using the device-code flow, or use a Moonshot API key.

3. Add Composio with /mcp-config

In current versions of Kimi Code, MCP servers are managed inside the app, not with a shell subcommand. From the interactive UI, run:

bash
/mcp-config
Kimi Code MCP config flow for adding the Composio MCP server

Tell it the server name and URL in plain language. For example:

Server name is Composio, and here is the server URL: https://connect.composio.dev/mcp

Kimi Code asks whether to add it globally, at ~/.kimi-code/mcp.json, or project-local for the current checkout, then writes the entry for you:

bash
{
  "mcpServers": {
    "Composio": {
      "url": "https://connect.composio.dev/mcp"
    }
  }
}

There is no transport field to set. Kimi Code infers HTTP from the url.

4. Restart the session

The new server is picked up on a fresh session, not the current one. Start a new session:

bash
/new

On the new session, Kimi Code detects that the server needs authorization and prompts you to run:

bash
/mcp-config login Composio

5. Authorize with OAuth

Run the command Kimi suggests:

bash
/mcp-config login composio

Kimi Code opens Composio's authorization page or surfaces a URL. Approve access, then return to the session. You should see confirmation that the Composio MCP server is connected.

Composio authorization page for Kimi Code MCP setup

Check the connection status any time with /mcp. Composio should appear as connected with its tools listed.

Kimi Code showing Composio connected after OAuth authorization

Connect your Klaviyo account

Back in a Kimi Code session, ask the agent to connect to Klaviyo or give it any Klaviyo-related task.

For example, ask it to:

  • "Add new subscribers to main email list"
  • "Clone last week's campaign for reuse"
  • "Estimate recipients for upcoming product launch"

It will prompt you to authenticate and authorize access to Klaviyo.

That is it. Composio tools are now available in Kimi Code, and your Klaviyo account is ready to use.

Conclusion

You have successfully connected Klaviyo to Kimi Code using Composio Connect. Your agent can now manage Klaviyo from the terminal with natural language, without exposing credentials in prompts or local scripts.

Since the same Composio endpoint exposes 1,700+ apps, you can add Slack, Calendar, Linear, and more to the same server and chain them into cross-app workflows.

TOOLS

Supported Tools

Every Klaviyo action and event your agent gets out of the box.

Add Profile to List

Add up to 1000 existing profiles to a Klaviyo list by profile IDs or email addresses.

Assign campaign message template

Creates a non-reusable version of the template and assigns it to the message.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:write`

Bulk create client events

Submit client-side events to track profile activity using a public API key; the request can also update profile details and remove profile properties.

Bulk create events

Bulk create events for multiple profiles in a single request.

Cancel Campaign Send

Cancel or revert a campaign send job.

Create back in stock subscription

Use the server-side endpoint to subscribe to restock alerts, following the Back in Stock API guide.

Create campaign

Creates a campaign given a set of parameters, then returns it.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:write`

Create campaign clone

Clones an existing campaign, returning a new campaign based on the original with a new ID and name.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:write`

Create Campaign Recipient Estimation Job

Start an asynchronous task to estimate the number of recipients for a campaign.

Create campaign send job

Trigger a campaign to send asynchronously*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:write`

Create catalog category

Create a new catalog category.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Create catalog category relationships items

Create a new item relationship for the given category ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Create catalog item

Create a new catalog item.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Create catalog item relationships categories

Create a new catalog category relationship for the given item ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Create catalog variant

Create a new variant for a related catalog item.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Create client back in stock subscription

Use the endpoint for client-side back in stock notifications with a public API key.

Create Client Event V2

Create a client-side event in Klaviyo to track user interactions.

Create client subscription

Endpoint manages email/SMS opt-ins using consent and requires public API key for client use.

Create coupon

Creates a new coupon.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `coupons:write`

Create coupon code

Create a coupon code for a given coupon.

Create event

Create or update a profile event with minimum identifiers and metric name.

Create flow

Create a draft flow from an encoded flow definition.

Create form

Create a draft Klaviyo signup form from an encoded form definition.

Create list

Create a new list.*Rate limits*:Burst: `10/s`Steady: `150/m`Daily: `100/d` **Scopes:** `lists:write`

Create or update client profile

Update user profiles without tracking using a public client-side API; use a private server-side API for identifier changes.

Create or update client push token

This endpoint for mobile SDKs (iOS & Android) creates/updates push tokens using a public API key.

Create or Update Profile

Create or update a Klaviyo profile using an email, phone number, external ID, or anonymous ID and supplied attributes.

Create or update push token

Create or update a push token for mobile push notifications.

Create profile

Create a new profile.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `profiles:write`

Create segment

Create a segment.*Rate limits*:Burst: `1/s`Steady: `15/m`Daily: `100/d` **Scopes:** `segments:write`

Create tag

Create a tag in an account, optionally specifying its tag group.

Create tag group

Create tag groups up to 50 per account, defaulting to non-exclusive unless specified.

Create Tag Relationships

Associate a tag with other resources (flows, lists, segments, or campaigns) in Klaviyo.

Create template

Create a custom HTML template in Klaviyo, subject to the account limit of 1,000 templates.

Create template clone

Clone a template by its ID, but cloning fails if account has 1,000+ templates.

Create template render

Render an email template with specific context and return HTML and plain text.

Create webhook

Create a webhook to receive real-time notifications for specified Klaviyo events.

Delete campaign

Delete a campaign with the given campaign ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:write`

Delete catalog category

Delete a catalog category using the given category ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Delete catalog category relationships items

Delete item relationships for the given category ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Delete catalog item

Delete a catalog item with the given item ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Delete catalog item relationships categories

Delete catalog category relationships for the given item ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Delete catalog variant

Delete a catalog item variant with the given variant ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Delete coupon

Delete the coupon with the given coupon ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `coupons:write`

Delete coupon code

Deletes a coupon code specified by the given identifier synchronously.

Delete flow

Delete a flow with the given flow ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:write`

Delete form

Permanently delete a Klaviyo form by ID.

Delete list

Delete a list with the given list ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `lists:write`

Delete segment

Delete a segment with the given segment ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `segments:write`

Delete tag

Delete the tag with the given tag ID.

Delete tag group

Delete a specified tag group and its contents; associated resource links will be removed.

Delete Tag Relationships

Remove a tag's association with other resources like flows, campaigns, lists, or segments.

Delete template

Permanently delete a template from your Klaviyo account using its unique template ID.

Delete webhook

Permanently delete a webhook subscription from your Klaviyo account.

Get account

Retrieve a single account object by its account ID.

Get accounts

Use a private API key to fetch an associated account's details like contact info, timezone, and currency, as well as validate the key.

Get Bulk Create Coupon Codes Job

Tool to get a coupon code bulk create job with the given job ID.

Get Bulk Delete Catalog Items Job

Get a catalog item bulk delete job with the given job ID.

Get bulk profile import job

Get a bulk profile import job with the given job ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `lists:read` `profiles:read`

Get bulk profile import job errors

Get import errors for the bulk profile import job with the given ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `profiles:read`

Get bulk profile import job lists

Get list for the bulk profile import job with the given ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `lists:read`

Get bulk profile import job profiles

Get profiles for the bulk profile import job with the given ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `profiles:read`

Get bulk profile import job relationships lists

Get list relationship for the bulk profile import job with the given ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `lists:read`

Get bulk profile import job relationships profiles

Get profile relationships for the bulk profile import job with the given ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `profiles:read`

Get bulk profile import jobs

Get bulk profile import jobs, with up to 100 jobs per request.

Get bulk update catalog items job

Get a catalog item bulk update job with the given job ID.

Get Bulk Update Categories Job

Retrieve a catalog category bulk update job by its ID from Klaviyo.

Get Bulk Update Variants Job

Tool to retrieve a catalog variant bulk update job by its ID.

Get Campaign

Retrieve a specific campaign by its ID from Klaviyo.

Get campaign campaign messages

Retrieve messages belonging to a campaign; requires `campaigns:read`.

Get campaign message

Returns a specific message based on a required id.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read`

Get campaign message campaign

Return the related campaign*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read`

Get campaign message relationships campaign

Returns the ID of the related campaign*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read`

Get campaign message relationships template

Returns the ID of the related template*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read` `templates:read`

Get campaign message template

Return the related template*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read` `templates:read`

Get campaign recipient estimation

Get estimated recipients for a given campaign ID using `Create Campaign Recipient Estimation Job`.

Get campaign recipient estimation job

Retrieve the status of a recipient estimation job triggered with the `Create Campaign Recipient Estimation Job` endpoint.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read`

Get campaign relationships campaign messages

Returns the IDs of all messages associated with the given campaign.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read`

Get campaign relationships tags

Returns the IDs of all tags associated with the given campaign.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `campaigns:read` `tags:read`

Get Campaigns

Retrieve a page of Klaviyo campaigns filtered by channel, with optional additional filtering and sorting.

Get campaign send job

Get a campaign send job*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:read`

Get campaign tags

Return all tags that belong to the given campaign.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `campaigns:read` `tags:read`

Get catalog categories

Retrieve up to 100 account catalog categories, sortable by creation date.

Get catalog category

Get a catalog category with the given category ID.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `catalogs:read`

Get catalog category items

Retrieve up to 100 sorted items per request from a category using the category ID.

Get catalog category relationships items

Retrieve catalog item identifiers associated with a category, up to 100 per request.

Get catalog item

Get a specific catalog item with the given item ID.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `catalogs:read`

Get catalog item categories

Retrieve the catalog categories for an item by ID, sorted by 'created' date, with a 100-category maximum per request.

Get catalog item relationships categories

Retrieve catalog category identifiers associated with an item, up to 100 per request.

Get catalog items

Retrieve up to 100 sorted catalog items per account, with `$custom` integration and `$default` type.

Get catalog item variants

Retrieve up to 100 variants per request for a specific item ID, sortable by creation date.

Get catalog variant

Get a catalog item variant with the given variant ID.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `catalogs:read`

Get catalog variants

Retrieve up to 100 account variants per request, sortable by creation date.

Get coupon

Get a specific coupon by coupon ID.

Get coupon code

Returns a Coupon Code specified by the given identifier.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `coupon-codes:read`

Get coupon code bulk create job

Get a coupon code bulk create job with the given job ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `coupon-codes:read`

Get coupon code bulk create jobs

Get coupon code bulk create jobs, with cursor pagination and optional status filtering.

Get coupon code relationships coupon

Gets a list of coupon code relationships associated with the given coupon id*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `coupon-codes:read`

Get coupon codes

Obtains coupon codes using necessary coupon or profile filters.

Get coupon codes for coupon

Gets a list of coupon codes associated with the given coupon id*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `coupon-codes:read`

Get coupon for coupon code

Get the coupon associated with a given coupon code ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `coupons:read`

Get Coupon ID for Coupon Code

Tool to get the coupon relationship associated with a given coupon code ID.

Get Coupon Relationships Coupon Codes

Retrieve coupon code relationship identifiers for a given coupon; pagination links may be returned, but subsequent pages cannot be requested through this tool.

Get coupons

Get all coupons in an account.

Get create categories job

Get a catalog category bulk create job with the given job ID.

Get create categories jobs

Get catalog category bulk create jobs, with up to 100 jobs per request.

Get create items job

Get a catalog item bulk create job with the given job ID.

Get create items jobs

Get catalog item bulk create jobs, with up to 100 jobs per request.

Get create variants job

Get a catalog variant bulk create job by its job ID to check its status and processing results.

Get create variants jobs

Get catalog variant bulk create jobs, with up to 100 jobs per request.

Get delete categories job

Get a catalog category bulk delete job with the given job ID.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `catalogs:read`

Get delete categories jobs

Get catalog category bulk delete jobs, with up to 100 jobs per request.

Get delete items jobs

Get catalog item bulk delete jobs, with up to 100 jobs per request.

Get delete variants job

Get a catalog variant bulk delete job with the given job ID.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `catalogs:read`

Get delete variants jobs

Get catalog variant bulk delete jobs, with optional status filtering and cursor pagination, returning a maximum of 100 jobs per request.

Get event

Get an event with the given event ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `events:read`

Get event metric

Get the metric for an event with the given event ID.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `events:read` `metrics:read`

Get event profile

Get the profile associated with an event with the given event ID.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `events:read` `profiles:read`

Get Event Relationships

Get metrics or profile relationships for a specific event.

Get events

Get all events in an account Requests can be sorted by the following fields: `datetime`, `timestamp` Returns a maximum of 200 events per page.*Rate limits*:Burst: `350/s`Steady: `3500/m` **Scopes:** `events:read`

Get flow

Get a flow with the given flow ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:read`

Get flow action

Get a flow action from a flow with the given flow action ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:read`

Get flow action for message

Get the flow action for a flow message with the given message ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:read`

Get flow action messages

Retrieve flow messages for an action ID, with filtering, page size, and ascending or descending sorting.

Get Parent Flow for Flow Action

Get the parent flow associated with a given flow action ID.

Get flow action relationships messages

Retrieves up to 50 flow message relationships per request for a specified flow action ID, with cursor pagination.

Get flow flow actions

Get all flow actions associated with the given flow ID.

Get flow for flow action

Get the flow associated with the given action ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:read`

Get flow message

Get the flow message of a flow with the given message ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:read`

Get flow message relationships action

Get the flow action relationship for a specific flow message.

Get flow message relationships template

Returns the ID of the related template*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `templates:read`

Get flow message template

Return the related template*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `templates:read`

Get flow relationships flow actions

Retrieve flow action relationship identifiers for a flow ID, with filtering, sorting, and a configurable page size.

Get flow relationships tags

Return the tag IDs of all tags associated with the given flow.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:read` `tags:read`

Get flows

Get all flows in an account.

Get flow tags

Return all tags associated with the given flow ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `flows:read` `tags:read`

Get form

Get the form with the given ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `forms:read`

Get form for form version

Get the form associated with the given form version.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `forms:read`

Get form id for form version

Get the ID of the form associated with the given form version.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `forms:read`

Get forms

Get all forms in an account.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `forms:read`

Get form version

Retrieve detailed information about a specific form version by its ID.

Get image

Get the image with the given image ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `images:read`

Get images

Get all images in an account.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `images:read`

Get list

Retrieve a Klaviyo list by ID.

Get list profiles

Retrieve profiles in a list by ID, filterable by email/phone/push token/join date, sortable by join date.

Get List Relationships

Get profile membership relationships for a Klaviyo list.

Get list relationships tags

Returns the tag IDs of all tags associated with the given list.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `lists:read` `tags:read`

Get Lists

Retrieve paginated marketing lists from a Klaviyo account, with optional filtering and sorting.

Get list tags

Return all tags associated with the given list ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `lists:read` `tags:read`

Get metric

Get a metric with the given metric ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `metrics:read`

Get metrics

Get all metrics in an account.

Get profile

Get the profile with the given profile ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `profiles:read`

Get profile lists

Get list memberships for a profile with the given profile ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `lists:read` `profiles:read`

Get Profile Relationships

Tool to get list membership or segment membership relationships for a profile with the given profile ID.

Get Profiles

Retrieve profiles from your Klaviyo account.

Get profile segments

Get segment memberships for a profile with the given profile ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `profiles:read` `segments:read`

Get reviews

List Klaviyo review records with filtering, sparse fields, related events, sorting, and cursor pagination.

Get segment

Fetch a segment by ID with default rates of 75/s and 700/m, or with `additional-fields` at 1/s and 15/m.

Get segment profiles

Retrieve profiles in a segment by ID, filtering by email, phone, token, or join date, and sorting by join date.

Get Segment Relationships

Get a page of profile membership or tag relationships for a segment, with pagination links when returned.

Get segments

Fetch segments from an account with filters like `name`, `created`, and `updated`.

Get segment tags

Return all tags associated with the given segment ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `segments:read` `tags:read`

Get tag

Retrieve the tag with the given tag ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `tags:read`

Get tag group

Retrieve the tag group with the given tag group ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `tags:read`

Get tag group relationships tags

Returns the tag IDs of all tags inside the given tag group.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `tags:read`

Get tag groups

Retrieve up to 25 tag groups per account, sortable/filterable by specific attributes.

Get tag group tags

Return the tags for a given tag group ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `tags:read`

Get Tag Relationships

Tool to retrieve relationship IDs for a tag.

Get tags

Retrieve up to 50 account tags at once, filterable/sortable by name or id, with cursor pagination.

Get tag tag group

Returns the tag group resource for a given tag ID.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `tags:read`

Get template

Get a template by ID, optionally requesting specific fields; the action raises an error if a requested field is absent from the response.

Get templates

Retrieve account templates with sorting options (`id`, `name`, `created`, `updated`).

Get translations

List translations through Klaviyo's beta, non-production API with filtering, sparse fields, related resources, sorting, and cursor pagination.

Get update categories jobs

Get all catalog category bulk update jobs.

Get update items job

Get a catalog item bulk update job with the given job ID.

Get update items jobs

Get catalog item bulk update jobs, with status filtering and cursor pagination, returning a maximum of 100 jobs per request.

Get update variants jobs

Get all catalog variant bulk update jobs.

Get Variant IDs for Catalog Item

Tool to get all variant IDs related to a given catalog item ID.

Get version ids for form

Get the IDs of the form versions for the given form.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `forms:read`

Get versions for form

Get the form versions for the given form.*Rate limits*:Burst: `3/s`Steady: `60/m` **Scopes:** `forms:read`

Get webhook

Get the webhook with the given ID.*Rate limits*:Burst: `1/s`Steady: `15/m` **Scopes:** `webhooks:read`

Get webhooks

Get webhooks in an account; the response can include pagination links.

Get webhook topic

Retrieve details of a specific webhook topic by its ID.

Get webhook topics

Get webhook topics in a Klaviyo account; the response can include pagination links.

Merge profiles

Merge one or more source profiles into a destination profile.

Query campaign values

Returns the requested campaign analytics values data*Rate limits*:Burst: `1/s`Steady: `2/m`Daily: `225/d` **Scopes:** `campaigns:read`

Query flow series

Returns time-series analytics data for flows, enabling performance tracking over time intervals.

Query flow values

Returns the requested flow analytics values data*Rate limits*:Burst: `1/s`Steady: `2/m`Daily: `225/d` **Scopes:** `flows:read`

Query form series

Return Klaviyo form performance metrics broken into time intervals.

Query form values

Return aggregate Klaviyo form performance statistics for a timeframe.

Query metric aggregates

Query aggregated metric measurements with grouping, sorting, and time-based filters.

Remove Profile from List

Remove up to 1000 profiles from a Klaviyo list by profile IDs or email addresses.

Request profile deletion

To delete a profile, use only one identifier: email, phone number, or ID.

Spawn bulk profile import job

Initiate a job to create/update a batch of profiles, up to 10,000 with a max size of 5MB per request.

Spawn coupon code bulk create job

Create a coupon-code-bulk-create-job to bulk create a list of coupon codes.

Spawn create categories job

Create bulk job for up to 100 catalog categories with a 5MB size limit and a max of 500 concurrent jobs.

Spawn create items job

Create batches of up to 100 catalog items with a 5MB size limit using the bulk job, which allows 500 concurrent jobs.

Spawn create variants job

Initiate a job to bulk create up to 100 catalog variants, with a 5MB payload size limit.

Spawn delete categories job

Delete multiple catalog categories in bulk, with a limit of 100 per request and a 5MB payload size.

Spawn delete items job

Delete batches of catalog items with a bulk job, max 100 items/request, 5MB size limit, and up to 500 concurrent jobs.

Spawn delete variants job

Delete multiple catalog variants with a bulk job, max 100 per request, 5MB size limit.

Spawn update categories job

Create a job to bulk update up to 100 categories, with a 5MB size limit and a maximum of 500 concurrent jobs.

Spawn update items job

You can bulk update up to 100 catalog items with a 5MB payload limit.

Spawn update variants job

Create a job to bulk update up to 100 catalog variants with a 5MB payload limit.

Subscribe profiles

Submit a bulk job to subscribe profiles to marketing, optionally adding them to a list; supports double opt-in and historical imports, and may reset opt-outs for returning users.

Suppress profiles

Suppress profiles by email, segment, or list ID to stop email marketing, regardless of consent.

Unregister client push token

This endpoint unsubscribes a push token, for use with Klaviyo's mobile SDKs and a public API key.

Unsubscribe profiles

Opt-out profiles from email or SMS marketing.

Unsubscribe Profiles Bulk

Submit a bulk unsubscription request for up to 100 email addresses and a Klaviyo list ID.

Unsuppress profiles

Remove 'USER_SUPPRESSED' blocks on profiles manually via email, segment, or list ID.

Unsuppress Profiles (Bulk)

Submit a bulk request to remove USER_SUPPRESSED email marketing suppressions from profiles identified by email address; other suppression reasons remain unchanged.

Update Campaign

Update a campaign's settings, including its name, audiences, send options, tracking options, and send strategy; requires `campaigns:write`.

Update campaign message

Update a campaign message*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `campaigns:write`

Update catalog category

Update a catalog category with the given category ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Update Catalog Category Relationships

Tool to update item relationships for a catalog category.

Update catalog category relationships items

Update item relationships for the given category ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Update catalog item

Update a catalog item with the given item ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Update catalog item relationships categories

Update catalog category relationships for the given item ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Update catalog variant

Update a catalog item variant with the given variant ID.*Rate limits*:Burst: `75/s`Steady: `700/m` **Scopes:** `catalogs:write`

Update coupon

Update an existing coupon's description by coupon ID.

Update coupon code

Updates a coupon code specified by the given identifier synchronously.

Update flow status

Update the status of a flow with the given flow ID, and all actions in that flow.

Update form

Update a Klaviyo form's name or replace its complete stored definition.

Update image

Update an image's name or hidden status by image ID.

Update list

Update the name of a list with the given list ID.*Rate limits*:Burst: `10/s`Steady: `150/m` **Scopes:** `lists:write`

Update profile

Update a Klaviyo profile by ID with supplied attributes.

Update segment

Update a segment with the given segment ID.*Rate limits*:Burst: `1/s`Steady: `15/m`Daily: `100/d` **Scopes:** `segments:write`

Update tag

Update the tag with the given tag ID.

Update tag group

Update the tag group with the given tag group ID.

Update template

Update an existing email template by ID.

Update webhook

Update the webhook with the given ID.

Upload image from file

Upload an image from a file.

Upload image from url

Import an image from a URL or data URI.

FAQ

Frequently asked questions

Start with Klaviyo.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Klaviyo tool your agent needs.Free to start.

Start building