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
tweet.read
View all posts you can see, including those from protected accounts.
list.read
View Lists, members, and followers of Lists you created or are a member of, including private Lists.
list.write
Create and manage Lists on your behalf.
users.read
View any account you can see, including 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[]