klaviyo

name

klaviyo

description

Klaviyo is a marketing automation platform built for eCommerce. It helps businesses deliver personalized email and SMS campaigns based on customer data and shopping behavior. Read and write Klaviyo data through One: tags, lists, profiles, catalogcategories, catalogitems, flows and more, 304 actions with real parameter documentation. Use whenever the user asks to look something up in Klaviyo, create or update a record there, or build code against the Klaviyo API.

Klaviyo through One

Klaviyo is a marketing automation platform built for eCommerce. It helps businesses deliver personalized email and SMS campaigns based on customer data and shopping behavior.

One exposes Klaviyo through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform klaviyo if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Klaviyo is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Klaviyo account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Tags

Action	Method	Path	Action id
Get a Tag	GET	/api/tags/{{id}}	conn_mod_def::GJ4txDsB8rA::N4tSwq5pT8GmgAk91OMqkw
Get a Tag’s Tag Group ID	GET	/api/tags/{{id}}/relationships/tag-group	conn_mod_def::GJ4txOAZerM::8haMnPG9RqCv2mLQOC5BDQ
Get Campaign IDs for a Tag	GET	/api/tags/{{id}}/relationships/campaigns	conn_mod_def::GJ4txEHj_qw::tY4VHKbYSTCLISqSGxI8xw
Get Flow IDs for a Tag	GET	/api/tags/{{id}}/relationships/flows	conn_mod_def::GJ4txGCryNA::ljeL-M7DTh6EUKolSs97Xg
Get List IDs for a Tag	GET	/api/tags/{{id}}/relationships/lists	conn_mod_def::GJ4txDC4svs::9MlOOls7R2acIKTuqK4mxQ
Get Segment IDs for a Tag	GET	/api/tags/{{id}}/relationships/segments	conn_mod_def::GJ4txDZSvlM::LSxmj8TvSTWmJuiaL77nCg
Get Tags for a List	GET	/api/lists/{{id}}/tags	conn_mod_def::GJ4ttt-tPts::QVvXE11RS8WNUAe2397dLw
List Tags	GET	/tags	conn_mod_def::GJ4txXo1rMU::R6Yd4EsoRE6xOyVw5K08XQ
Associate a Tag with Lists	POST	/api/tags/{{id}}/relationships/lists	conn_mod_def::GJ4txe_r9u0::CnMLDq0nT-eYRG8BwBADDA
Create Tag	POST	/tags	conn_mod_def::GJ4tw2Zlweo::gGYB6JlJTbmx8Zyzfd-Ieg
Delete a Tag	DELETE	/api/tags/{{id}}	conn_mod_def::GJ4tw1GUH3c::nHVBoDuNQ7yflzazW7n8xQ
Remove a Tag from Campaigns	DELETE	/api/tags/{{id}}/relationships/campaigns	conn_mod_def::GJ4txXU43_g::2lq8-BSxRFGbud4k6vLRuA

6 more Tags actions are available through search.

Lists

Action	Method	Path	Action id
Get a List	GET	/api/lists/{{id}}	conn_mod_def::GJ4ttlaoWtk::-wPOTZRFTzGqkLJ2YDs16w
Get a List’s Profile IDs (Relationships)	GET	/api/lists/{{id}}/relationships/profiles	conn_mod_def::GJ4ttzG_M58::BdjbuvVPT_esqxeUrn7CCQ
Get Lists	GET	/lists	conn_mod_def::GJ4tty0O4QE::gfyVQcR4TFWQXZ0w10-_5A
Get Profiles for a List	GET	/api/lists/{{id}}/profiles	conn_mod_def::GJ4ttvKbnzY::HmYHmJfrTBOvPMaNCpD5jg
Get Tag IDs for a List	GET	/api/lists/{{id}}/relationships/tags	conn_mod_def::GJ4tttTunpM::XwCGRzRmRKaBHruyTi0WUg
List Flow Trigger IDs for a List	GET	/api/lists/{{id}}/relationships/flow-triggers	conn_mod_def::GJ4ttflarEw::s3V413GfQ0Cp1p5bkhWebA
Add Profiles to a List	POST	/api/lists/{{id}}/relationships/profiles	conn_mod_def::GJ4ttXFDlnA::X8V7-2kRQrCemUieIArrhg
Create List	POST	/lists	conn_mod_def::GJ4ttfpCfMw::1bTepFxXSCG7QCKors9Hvw
Delete a List	DELETE	/api/lists/{{id}}	conn_mod_def::GJ4ttgqdfPk::xQtxktRgQhejKdfexzP0iA
Remove Profiles from a List	DELETE	/api/lists/{{id}}/relationships/profiles	conn_mod_def::GJ4tt7xlJi0::DggE0lR8Q-mStl8j7rtXGA
Update a List	PATCH	/api/lists/{{id}}	conn_mod_def::GJ4tt8ZCuPA::5HkJqcV9RBmJb0YEHMCkmQ

Profiles

Action	Method	Path	Action id
Get a Profile by ID	GET	/api/profiles/{{id}}	conn_mod_def::GJ4tvkBPMgs::KfLN7BdHRf2LZXzou0oQRA
Get List IDs for a Profile	GET	/api/profiles/{{id}}/relationships/lists	conn_mod_def::GJ4tvXr394A::Cq2BGzVcR5-zqnzUeCCu6A
Get Lists for a Profile	GET	/api/profiles/{{id}}/lists	conn_mod_def::GJ4tvjJ2hEA::-jEZsYmlSxKIz4XZ5vl8KQ
Get Profiles	GET	/profiles	conn_mod_def::GJ4tvtpPZB4::bVRUqJrKQfGIAmwepJmFZg
Get Push Token IDs for a Profile	GET	/api/profiles/{{id}}/relationships/push-tokens	conn_mod_def::GJ4tvr_EHX8::m7NU6wOUS6SBOVvVwWjUlw
Get Segment IDs for a Profile	GET	/api/profiles/{{id}}/relationships/segments	conn_mod_def::GJ4tv4eD4dQ::q2Xd3VNWT6We6cASfIo9jg
Get Segments for a Profile	GET	/api/profiles/{{id}}/segments	conn_mod_def::GJ4tv42qWXY::rNLNzhaOSViq9ECZ2Dps8A
Create or Update a Profile	POST	/profile-import	conn_mod_def::GJ4tvDdOIYc::fazk0o0lRG-VW2Bpq_si_Q
Create Profile	POST	/profiles	conn_mod_def::GJ4tvCvS7YE::RiZ9-tQfTReAcDyhjtO1Gg
Merge Profiles (Merge a Source Profile into a Destination Profile)	POST	/profile-merge	conn_mod_def::GJ4tv46txKg::8kPn48iKTiqDssJ2GWYRcQ
Update a Profile	PATCH	/api/profiles/{{id}}	conn_mod_def::GJ4tv4_KlTU::eThXZxyTS_ehOaX1tsbvhQ

CatalogCategories

Action	Method	Path	Action id
Get a Catalog Category	GET	/api/catalog-categories/{{id}}	conn_mod_def::GJ4tp6jQYvY::L0FH1GseSZCQoAYzRF2ryg
Get Catalog Categories	GET	/catalog-categories	conn_mod_def::GJ4tpto3MWk::3dYXK53uSmunHIQjZSnP9w
Get Item IDs for a Catalog Category	GET	/api/catalog-categories/{{id}}/relationships/items	conn_mod_def::GJ4tqGFox88::LMOaNG62SgSjHSiVo5RA1g
Get Items for a Catalog Category	GET	/api/catalog-categories/{{id}}/items	conn_mod_def::GJ4tqGQ9ev4::garWhreTTN-WGtw_r3sBUQ
Add Items to a Catalog Category	POST	/api/catalog-categories/{{id}}/relationships/items	conn_mod_def::GJ4toSAgZDg::IkU_ZXEnRBC6ed1yjHmLZA
Create a Catalog Category	POST	/catalog-categories	conn_mod_def::GJ4to01Pqxo::-8WRHufNSu2WExhcQB3I1Q
Delete a Catalog Category	DELETE	/api/catalog-categories/{{id}}	conn_mod_def::GJ4to0e3ano::xnU5vm7RRj-0MykJZs1LlA
Remove Items from a Catalog Category	DELETE	/api/catalog-categories/{{id}}/relationships/items	conn_mod_def::GJ4tqQ08d0o::1Fc1Ec6XQiKGXV_iacy3pA
Update a Catalog Category	PATCH	/api/catalog-categories/{{id}}	conn_mod_def::GJ4tqQgeQzw::XWsmUai_SUW_z-OoqIdPzA
Update Items for a Catalog Category	PATCH	/api/catalog-categories/{{id}}/relationships/items	conn_mod_def::GJ4tqdttPpY::_CcSWMvuTtSg_hrKrwINNw

CatalogItems

Action	Method	Path	Action id
Get a Catalog Item	GET	/api/catalog-items/{{id}}	conn_mod_def::GJ4tp4Xcd00::KvdQIyJbRVmmWxJpveNKlA
Get a Catalog Item’s Categories	GET	/api/catalog-items/{{id}}/categories	conn_mod_def::GJ4tqGeJvAM::kDLhbjVgT7aaVHdxmektqQ
Get Catalog Items	GET	/catalog-items	conn_mod_def::GJ4tp8sBzN8::7u_3MjhMQv2x7u7rlzKnBA
Get Variant IDs for a Catalog Item	GET	/api/catalog-items/{{id}}/relationships/variants	conn_mod_def::GJ4tqIlHzuw::rkPGLiwdTVqdr9UOPF84Hw
Add Categories to a Catalog Item	POST	/api/catalog-items/{{id}}/relationships/categories	conn_mod_def::GJ4toR64-g4::poV4BBOFR8yiKEek0sSFsQ
Create Catalog Item	POST	/catalog-items	conn_mod_def::GJ4to0wyRXw::0XL4QRuFSHGEjQGKwNf7mw
Delete a Catalog Item	DELETE	/api/catalog-items/{{id}}	conn_mod_def::GJ4to6H3o1Y::APr-RncHSfqIgNTPnaunMw
Remove Categories from a Catalog Item	DELETE	/api/catalog-items/{{id}}/relationships/categories	conn_mod_def::GJ4tqUxxl2g::aZWiGN5STBC8vCNXiEQ_yQ
Update a Catalog Item	PATCH	/api/catalog-items/{{id}}	conn_mod_def::GJ4tqVnrGA4::q2P4Hxl3TNK9IF5JRKHT2A
Update Categories for a Catalog Item	PATCH	/api/catalog-items/{{id}}/relationships/categories	conn_mod_def::GJ4tqjFURnc::HasEHd89QwexwM4jPPuKiQ

Flows

Action	Method	Path	Action id
Get a Flow	GET	/api/flows/{{id}}	conn_mod_def::GJ4tsgUd-2M::w8rdFzh5R0KV8Rm1eb7tOQ
Get a Flow for a Flow Action	GET	/api/flow-actions/{{id}}/flow	conn_mod_def::GJ4tsfKl11Q::eaXEqiNZT32OItdb4eHPcQ
Get a Flow’s Action Relationship IDs	GET	/api/flows/{{id}}/relationships/flow-actions	conn_mod_def::GJ4tsS8cR_8::8xPD3_WVQSemoAYVwFI2bw
Get Flows	GET	/flows	conn_mod_def::GJ4tssxlRSw::YqjmkHasRAuZ7tFos0Es6w
Get Flows Triggered by a List	GET	/api/lists/{{id}}/flow-triggers	conn_mod_def::GJ4ttg8VxPM::lE0gN6SYSOubGcDW3AsCiA
Get Flows Triggered by a Segment	GET	/api/segments/{{id}}/flow-triggers	conn_mod_def::GJ4tweqFsZM::bUjIdpCOQL-YmFTW2rq42Q
Get Tag IDs for a Flow	GET	/api/flows/{{id}}/relationships/tags	conn_mod_def::GJ4tsq9YfF8::4v5ZbiVmQYGnoSKSQ-kJyw
Create a Flow	POST	/flows	conn_mod_def::GJ4tsSkDvMg::5b19bRh4SFC-xAPyXCDj6A
Delete a Flow	DELETE	/api/flows/{{id}}	conn_mod_def::GJ4tsR9rXyM::mrKH3vw_Rrana0v_qXk2fw
Update a Flow’s Status	PATCH	/api/flows/{{id}}	conn_mod_def::GJ4ts2mLPVY::QCbSLQrlR8mMmYbabiMN4Q

Segments

Action	Method	Path	Action id
Get a Segment	GET	/api/segments/{{id}}	conn_mod_def::GJ4twsKbuG8::SWYOO6STRBy6kPolrGHcFw
Get IDs for Flows Triggered by a Segment	GET	/api/segments/{{id}}/relationships/flow-triggers	conn_mod_def::GJ4twetIAxU::oxASsQMlQz-hlhsKV-m_SQ
Get Profile IDs for a Segment	GET	/api/segments/{{id}}/relationships/profiles	conn_mod_def::GJ4twfgedVk::iDD2OJhjQpeFx0HqU86Q5Q
Get Profiles for a Segment	GET	/api/segments/{{id}}/profiles	conn_mod_def::GJ4twtcnDT8::TaTQMA_jR1a9nHfOb2SK4w
Get Segments	GET	/segments	conn_mod_def::GJ4twt1nfCE::Mu8KUdbzQ_OeH05hkfBQUQ
Get Tag IDs for a Segment	GET	/api/segments/{{id}}/relationships/tags	conn_mod_def::GJ4twrd6lQk::C4DbDgTySJWRO46qxI6fOA
Get Tags for a Segment	GET	/api/segments/{{id}}/tags	conn_mod_def::GJ4twr_Qx50::WMyqCarqR5OqnwyJgtvelA
Create Segment	POST	/segments	conn_mod_def::GJ4twhFXLR0::YcC3JkCyS6uX_gZOQ5THMQ
Delete a Segment	DELETE	/api/segments/{{id}}	conn_mod_def::GJ4twjZcVT0::-X7IWvTYTnCvVDFazVMHEA
Update a Segment	PATCH	/api/segments/{{id}}	conn_mod_def::GJ4tw1KRK2U::QfrzPzc_QpyeEEAWWhmBmg

CampaignMessages

Action	Method	Path	Action id
Get a Campaign Message	GET	/api/campaign-messages/{{id}}	conn_mod_def::GJ4tnudftbY::uuvvLoyKSf6ush96dZnqqQ
Get a Campaign Message’s Related Campaign ID	GET	/api/campaign-messages/{{id}}/relationships/campaign	conn_mod_def::GJ4tnd30G4g::Xqme8ejZQd68qN5N_OynfQ
Get a Campaign Message’s Related Template ID	GET	/api/campaign-messages/{{id}}/relationships/template	conn_mod_def::GJ4toJLK-8s::FvwDx-a1T1WGL6cGHGVgrg
Get a Campaign’s Message IDs	GET	/api/campaigns/{{id}}/relationships/campaign-messages	conn_mod_def::GJ4tn7qjuvo::F9BKy7TuTUOxd3cFzwOAbg
Get Messages for a Campaign	GET	/api/campaigns/{{id}}/campaign-messages	conn_mod_def::GJ4tn9RrwSk::j-wXiT_qTcicBYvlwSDhng
Assign a Template to a Campaign Message	POST	/api/campaign-message-assign-template	conn_mod_def::GJ4tnVqV3q4::Hs3AQxVLQwiZ5uYvT7u55A
Update a Campaign Message	PATCH	/api/campaign-messages/{{id}}	conn_mod_def::GJ4toRwa0e0::-Rlc6QHiTX6sBCSlnHuIJw
Update Image for a Campaign Message	PATCH	/api/campaign-messages/{{id}}/relationships/image	conn_mod_def::GJ4toROjnps::q3t78ujJTl-bK5yKxhXhrg

CouponCodes

Action	Method	Path	Action id
Get a Coupon Code	GET	/api/coupon-codes/{{id}}	conn_mod_def::GJ4trPF_kEY::67Cb3TBiSpmjFdb7GD8G7g
Get a Coupon Code’s Related Coupon ID	GET	/api/coupon-codes/{{id}}/relationships/coupon	conn_mod_def::GJ4trdvr7ZY::-VH5WMEBR_WSOXA2WURVWg
Get Coupon Code IDs for a Coupon	GET	/api/coupons/{{id}}/relationships/coupon-codes	conn_mod_def::GJ4trQwxxkQ::X3lVLAfbRIeDKT7aGr1Ecg
Get Coupon Codes	GET	/api/coupon-codes	conn_mod_def::GJ4trR6TS34::_OVgV10pTF--0JR1oPgRdQ
List Coupon Codes for a Coupon	GET	/api/coupons/{{id}}/coupon-codes	conn_mod_def::GJ4trQlntHA::6w2jW1FBQR2ieub7gH0YoQ
Create Coupon Code	POST	/coupon-codes	conn_mod_def::GJ4trF4Cd8U::ET6LGJj7QWuOO5XpG0hA_g
Delete a Coupon Code	DELETE	/api/coupon-codes/{{id}}	conn_mod_def::GJ4trCeRMlY::sbskRi9YQyS35Q699izRqw
Update a Coupon Code	PATCH	/api/coupon-codes/{{id}}	conn_mod_def::GJ4traSsFXA::EoF3VhrWSuKUSJgMgEgG0w

This lists 90 of 304 actions. For anything not here, call search_one_platform_actions with platform klaviyo. The full catalog is at https://www.withone.ai/knowledge/klaviyo.

When a call fails

The error comes from Klaviyo, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/klaviyo

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.