POST /2/lists

Enables the authenticated user to create a List.

Endpoint URL

https://api.twitter.com/2/lists

Authentication and rate limits

Authentication methods
supported by this endpoint

OAuth 1.0a User context

Rate limit

User rate limit: 300 requests per 15-minute window

JSON body parameters

NameTypeDescription
name
 Required 
stringThe name of the List you wish to create.
description
 Optional 
stringDescription of the List.
private
 Optional 
booleanDetermine whether the List should be private.


Example requests

      curl -X POST "https://api.twitter.com/2/lists" -H "Authorization: OAuth $OAUTH_SIGNATURE" -H "Content-type: application/json" -d '{"name": "test v2 create list"}'
    

Example responses

      {
  "data": {
    "id": "1441162269824405510",
    "name": "test v2 create list"
  }
}
    

Response fields

NameTypeDescription
idnumberThe id of the newly created List.
namestringThe name of the newly created List.
Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.