Manage Lists

Create, update, and delete Lists

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