Manage Lists

Use the X API v2 Manage Lists endpoints to create, update, and delete X Lists on behalf of authenticated users and organize accounts into curated timelines.

The Manage Lists endpoints let you create, update, and delete Lists on behalf of authenticated users.

Overview

Create

Create a new List

Update

Update List name and description

Delete

Delete a List

---

Endpoints

Method	Endpoint	Description
POST	/2/lists	Create a new List
PUT	/2/lists/:id	Update a List
DELETE	/2/lists/:id	Delete a List

---

Example: Create a List

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News",
    "description": "My favorite tech journalists",
    "private": false
  }'

Example response

{
  "data": {
    "id": "1234567890",
    "name": "Tech News"
  }
}

---

Getting started

Prerequisites

• An approved developer account
• A Project and App in the Developer Console
• User Access Tokens via OAuth 2.0 PKCE

Quickstart

Create your first List

Integration guide

Key concepts and best practices

List members

Add and remove members

API Reference

Full endpoint documentation