HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference
ChangelogHelp CenterCommunityContact Us

Create List

post
https://a.klaviyo.com/api/lists

Create a new list.

Rate limits:
Burst: 10/s
Steady: 150/m
Daily: 150/d

Scopes:
lists:write

Query Params
fields[list]
array of strings

For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets

fields[list]
Body Params
data
object
required
Headers
string
required
Defaults to 2026-04-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Updated over 1 year ago

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json

Updated over 1 year ago

Power smarter
digital relationships
By entering your information and clicking “Sign up,” you consent to receive marketing emails (such as newsletters, blog posts, webinars, event invitations and new product updates) from Klaviyo from time to time. You can unsubscribe at any time by clicking on the “Unsubscribe” link at the bottom of our emails. For more information on how we process your personal information and what rights you have in this respect, please see our Privacy Policy.
Terms and Privacy Trademarks Security