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 2.0 Authorization Code with PKCE

OAuth 1.0a User Context

Rate limit

User rate limit (OAuth 2.0): 300 requests per 15-minute window per each authenticated user

User rate limit (OAuth 1.0a): 300 requests per 15-minute window per each authenticated user

OAuth 2.0 scopes required by this endpoint

tweet.read

users.read

list.read

list.write

Learn more about OAuth 2.0 Authorization Code with PKCE

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: Bearer $ACCESS_TOKEN" -H "Content-type: application/json" -d '{"name": "test v2 create list"}'
    
      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.