Skip to main content
POST
Create Lists

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://api.x.com/2/oauth2/authorize
Token URL
https://api.x.com/2/oauth2/token
Scopes4
users.read
View any account you can see, including protected accounts.
list.write
Create and manage Lists on your behalf.
list.read
View Lists, members, and followers of Lists you created or are a member of, including private Lists.
tweet.read
View all posts you can see, including those from protected accounts.

Body

application/json
name
string
required

Name of the List (1-25 characters).

Required string length: 1 - 25
description
string

Description of the List (up to 100 characters).

Maximum string length: 100
private
boolean

Whether the List is private.

Response

The request has succeeded.

data
object
errors
object[]