HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference
ChangelogHelp CenterCommunityContact Us
These docs are for v2023-12-15. Click to read the latest docs for v2026-01-15.

Create List

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

Create a new list.

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

Scopes:
lists:write

Body Params
data
object
required
Headers
string
required
Defaults to 2023-12-15

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

Responses

Updated over 2 years ago

Language
Credentials
Header
Response 
 Choose an example:
application/json
Updated over 2 years 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