How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Klaviyo

Klaviyo Lists API

lists

Documentation Provider Profile APIs.io OpenAPI GitHub

Klaviyo Lists API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include List. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.

This API exposes 13 operations across 8 paths, and defines 49 schemas. It is described by OpenAPI 3.2.0, at version 2026-04-15.

Requests are made against a single base URL, https://a.klaviyo.com.

13 operations 8 paths 49 schemas 2 DELETE8 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-04-15
Base URL
https://a.klaviyo.com
Authentication
API Key
Contact
Klaviyo Developer Experience Team
License
License
Terms of Service
View terms
Resource Areas
1

Authentication & Security 1

Klaviyo Lists API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Klaviyo-API-Key). By default, every request must be authenticated.

  • Klaviyo-API-Key — Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…

Paths & Operations 13

Across 8 paths, the API surfaces 13 operations — 2 DELETE, 8 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Lists 13

lists

GET
/api/lists
Get Lists
get_lists 9 params → 2004XX5XX
POST
/api/lists
Create List
create_list 1 param body → 2014XX5XX
GET
/api/lists/{id}
Get List
get_list 7 params → 2004XX5XX
PATCH
/api/lists/{id}
Update List
update_list 2 params body → 2004XX5XX
DELETE
/api/lists/{id}
Delete List
delete_list 2 params → 2044XX5XX
GET
/api/lists/{id}/tags
Get Tags for List
get_tags_for_list 3 params → 2004XX5XX
GET
/api/lists/{id}/relationships/tags
Get Tag IDs for List
get_tag_ids_for_list 2 params → 2004XX5XX
GET
/api/lists/{id}/profiles
Get Profiles for List
get_profiles_for_list 8 params → 2004XX5XX
GET
/api/lists/{id}/relationships/profiles
Get Profile IDs for List
get_profile_ids_for_list 6 params → 2004XX5XX
POST
/api/lists/{id}/relationships/profiles
Add Profiles to List
add_profiles_to_list 2 params body → 2044XX5XX
DELETE
/api/lists/{id}/relationships/profiles
Remove Profiles from List
remove_profiles_from_list 2 params body → 2044XX5XX
GET
/api/lists/{id}/flow-triggers
Get Flows Triggered by List
get_flows_triggered_by_list 3 params → 2004XX5XX
GET
/api/lists/{id}/relationships/flow-triggers
Get IDs for Flows Triggered by List
get_ids_for_flows_triggered_by_list 2 params → 2004XX5XX

Schemas 49

The contract defines 49 schemas that model the data the API accepts and returns. The most detailed are ProfileLocation (10 properties), EmailMarketing (10 properties), PredictiveAnalytics (10 properties), WhatsappMarketingChannel (8 properties). Each schema is shown below with its type and property counts.

SegmentEnum
string
GetListMemberResponseCollection
object
2 properties 1 required
PatchListPartialUpdateResponse
object
2 properties 1 required
GetListRetrieveResponseCompoundDocument
object
3 properties 1 required
PostListCreateResponse
object
2 properties 1 required
WhatsappMarketingChannel
object
8 properties 3 required
TagResponseObjectResource
object
5 properties 4 required
FlowEnum
string
ListCreateQueryResourceObject
object
2 properties 2 required
GetListFlowTriggersRelationshipsResponseCollection
object
2 properties 1 required
GetFlowResponseCollection
object
2 properties 1 required
SMSMarketing
object
6 properties 2 required
WhatsappConversationalChannel
object
8 properties 3 required
SMSTransactional
object
6 properties 2 required
ListMemberResponseObjectResource
object
5 properties 3 required
ListEnum
string
CampaignEnum
string
RelationshipLinks
object
2 properties 2 required
FlowActionEnum
string
WhatsappTransactionalChannel
object
8 properties 3 required
ListRetrieveResponseObjectResource
object
5 properties 4 required
ProfileLocation
object
10 properties
ListMembersDeleteQuery
object
1 property 1 required
FlowResponseObjectResource
object
5 properties 4 required
CollectionLinks
object
5 properties 1 required
WhatsappChannel
object
3 properties
EmailMarketingListSuppression
object
3 properties 3 required
Subscriptions
object
4 properties
ListPartialUpdateQueryResourceObject
object
3 properties 3 required
GetListListResponseCollectionCompoundDocument
object
3 properties 1 required
ListCreateQuery
object
1 property 1 required
EmailChannel
object
1 property
PushMarketing
object
3 properties 2 required
TagGroupEnum
string
TagEnum
string
ListListResponseObjectResource
object
5 properties 4 required
ListMembersAddQuery
object
1 property 1 required
PushTokenEnum
string
ListPartialUpdateQuery
object
1 property 1 required
GetListProfilesRelationshipsResponseCollection
object
2 properties 1 required
ProfileEnum
string
EmailMarketing
object
10 properties 2 required
GetListTagsRelationshipsResponseCollection
object
2 properties 1 required
GetTagResponseCollection
object
2 properties 1 required
SMSChannel
object
2 properties
PushChannel
object
1 property
PredictiveAnalytics
object
10 properties
EmailMarketingSuppression
object
2 properties 2 required
ObjectLinks
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-lists-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

Klaviyo Accounts API
AE Profile APIs.io
Klaviyo Campaigns API
AE Profile APIs.io
Klaviyo Catalogs API
AE Profile APIs.io
Klaviyo Client API
AE Profile APIs.io
Klaviyo Conversations API
AE Profile APIs.io
Klaviyo Coupons API
AE Profile APIs.io
Klaviyo Custom Objects API
AE Profile APIs.io
Klaviyo Data Privacy API
AE Profile APIs.io
Klaviyo Events API
AE Profile APIs.io
Klaviyo Flows API
AE Profile APIs.io
Klaviyo Forms API
AE Profile APIs.io
Klaviyo Images API
AE Profile APIs.io
#List
← Back to K APIs
API Details
ID
klaviyo:klaviyo-lists-api
Base URL
https://a.klaviyo.com
Docs
https://developers.klaviyo.com/
Provider
Klaviyo
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=klaviyo-lists-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/klaviyo-lists-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Klaviyo Lists API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.