Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through pinning and unpinning Lists.
PrerequisitesBefore you begin, you’ll need:
  • A developer account with an approved App
  • User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)

​
Pin a List

1

Get your user ID and the List ID

You need your authenticated user’s ID and the ID of the List you want to pin. Find List IDs in the URL when viewing a List.
2

Pin the List

cURL
curl -X POST "https://api.x.com/2/users/2244994945/pinned_lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"list_id": "1454155907651158017"}'
3

Review the response

{
  "data": {
    "pinned": true
  }
}

​
Unpin a List

cURL
curl -X DELETE "https://api.x.com/2/users/2244994945/pinned_lists/1454155907651158017" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
Response: 
{
  "data": {
    "pinned": false
  }
}

​
Important notes

  • You can only pin Lists you follow or own
  • Pinned Lists appear at the top of your Lists in the X app
  • There’s a limit on how many Lists you can pin

​
Next steps

Pinned Lists lookup

Get your pinned Lists

List lookup

Get List details

API Reference

Full endpoint documentation