Skip to main content
POST
Pin List

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
Scopes3
tweet.read
View all posts you can see, including those from protected accounts.
users.read
View any account you can see, including protected accounts.
list.write
Create and manage Lists on your behalf.

Path Parameters

id
string
required

Unique identifier of a User

Pattern: ^[0-9]{1,19}$
Example:

"2244994945"

Body

application/json
list_id
string
required
Pattern: ^[0-9]{1,19}$

Response

The request has succeeded.

data
object
errors
object[]